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What will you learn from this book? 


Head First Java is a complete learning experience in Java and “What a fun and quirky 
object-oriented programming. With this book, you'll learn the Java book! I've taught Java 
language with a unique method that goes beyond how-to manuals and for many years and 
helps you become a great programmer. Through puzzles, mysteries, can honestly say this 
and soul-searching interviews with famous Java objects, you'll quickly is the most engaging 
get up to speed on Java's fundamentals and advanced topics including resource I've ever 
lambdas, streams, generics, threading, networking, and the dreaded seen for learning to 
desktop GUI. If you have experience with another programming language, program. It makes 
Head First Java will engage your brain with more modern approaches to me want to learn 


coding—the sleeker, faster, and easier to read, write, and maintain 


Java all over again." 
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—Angie Jones 
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experience that engages your mind, rather than by means of a text-heavy 
approach that puts you to sleep. 
JAVA 


US $69.99 CAN $87.99 
ISBN: 978-1-491-91077-1 


Ten pe 
NTT 


Other books in O’Reilly’s Head First series 


Head First Android Development 
Head First C# 

Head First Design Patterns 

Head First Git 

Head First Go 

Head First HTML and CSS 

Head First JavaScript Programming 
Head First Kotlin 

Head First Learn to Code 

Head First Object-Oriented Analysis and Design 
Head First PMP 

Head First Programming 

Head First Python 

Head First Software Development 
Head First SQL 

Head First Swift 

Head First Web Design 


Praise for Head First Java, 3rd Edition 


“What a fun and quirky book! I’ve taught Java for many years and can honestly say this is the most engag- 
ing resource I’ve ever seen for learning to program. It makes me want to learn Java all over again!” 
— Angie Jones, Java Champion 


“HFY has the clearest explanation of Java Streams and Lambdas I have ever read—without the hype! It 
teaches important functional programming concepts with humor and style. And it was so fun I wanted to 
learn Java all over again. If only everyone programmed Java like they teach in this book.” 

— Eric Normand, Clojure instructor and author of Grokking Simplicity 


“Oh how I wish I had had this book when I was learning Java! It is such fun to read, one forgets that it is a 
serious Java learning book. The third edition is a great step forward. It covers everything that a Java pro- 
grammer needs to know in 2022+ to become proficient in the Java language. To me the best though are 
the illustrations, which made me chuckle quite a few times. Very well done to the Java Champion authors: 
Kathy, Bert, and Trisha!” 

— Dr. Heinz M. Kabutz (The Java Specialists’ Newsletter, www.javaspecialists.eu) 


“T love Head First Java’s style of teaching, It is a ‘technical’ book but feels like fiction—hard to stop read- 
ing once you start with any chapter. It has fun and unconventional images, great analogies, fireside chats 
between a developer and compiler/runtime and so many more such features. It has a completely different 
and great way of teaching concepts that makes readers question their assumptions and beliefs, which I 
believe is crucial to letting any learner realize the power of their own curiosity. The authors of this book 
are no less than magicians. This 1s a must-read book for all Java developers to get started learning Java or 
to level up their existing skills in a fun way.” 

— Mala Gupta, Developer Advocate @ JetBrains, Author and Java Champion 


“T often get asked by folks new to the Java programming ecosystem, ‘What book should I start with?’ I 
always tell them Head First Java! The original editions by Kathy Sierra and Bert Bates flipped the old way 
of learning a programming language on its head, with a learner-centric way of teaching. It was simply 
revolutionary. Trisha Gee is one of the finest Java engineers and educators on the planet, and my go 
to person when I need something gnarly about the language explained in clear detail! The third edi- 
tion brought a huge smile to my face, not only for the trip down memory lane but because once more I 
learned new things about Java despite having spent over 20 years with it :-).” 

— Maritjn Verburg aka “The Diabolical Developer”; Java Champion and Principal 

Group Manager for Java @ Microsoft 


“The Head First Java book is legendary, and I can’t think of a better person than Trisha Gee to update 
it. I already knew Trisha was awesome, but I didn’t know she was funny. Now I do! The third edition is 
authoritative, entertaining, clear, and current. If there’s a better way to learn Java, I don’t know it.” 

— Holly Cummins, Senior Principal Quarkus Software Engineer, Red Hat 


“This book is a riot! It’s got curly braces, humor, objects, metaphors, syntax, fun, code, and a proper 
acknowledgment that the reader is human. It takes the process of learning seriously, but does so playfully 
and memorably. I love the metacognitive tips, the invitations to play the role of compiler, the stories, the 
visuals, and the sense that learning a programming language— like any learning—1is something that is 
open to anyone.” 


— Kevlin Henney, co-editor of 97 Things Every Java Programmer Should Know 


“T wish I’d known about this book when I’d been learning Java! For those looking to learn Java in a fun, hu- 
morous and captivating way (who knew that was possible?), and especially those who have not come from 
a traditional computer science background like myself, this is definitely the book for you. Never before 
have I laughed out loud at a programming book. It’s brilliantly written, witty, engaging, interactive, easy to 
follow and highly educational.” 

— Grace Jansen, Developer Advocate, IBM 


“If you’re just starting your journey learning how to program in Java, you’re faced with an overwhelm- 
ing choice of books and courses ready to get you to your destination. The problem 1s most focus purely 
on the technical information, making you frequently ask, “are we there yet?” Head First Java takes an 
altogether different approach making the adventure of learning both entertaining and educational. Using 
arrays of dogs, pool puzzles, five-minute mysteries and sharpen your pencil (who’d have thought you need 
a pencil to program?), this book makes learning fun, yet making sure you absorb all the essential details 
you'll need. I wish this had been available when I started learning Java!” 
— Simon Ritter, Deputy CTO at Azul and Java Champion 


“This book never disappoints. I still remember it from my early days at university and I am quite pleased to 
see this new improved version. Head First Java is very well put together with simple to understand English 
and coding examples. I highly recommend it to every Java developer.” 

— Nelson Djalo, Tech Entrepreneur, founder of Amigoscode.com learning platform 
and Amigoscode YouTube channel 


“Head First Java was the first book I had my son read when he wanted to learn Java. And there’s a reason: 
I knew the fun cartoons would captivate his attention like no other Java book I have seen before. Reading 
Head First Java was more like being on the playground than stuck in the classroom.” 
— Kevin Nilson, Google Software Engineer and Leader of the Silicon Valley Java User 


“T can only envy programmers who want to learn Java today, as they have this great book. I learned Java 
twenty years ago, and it was quite boring. But you'll never be bored with this book. I’ve never seen a Java 
book that has a battle between Java compiler and virtual machine. This is mind-blowing!” 

— Tagir Valeev, Java Champion and Technical Lead in IntelliJ IDEA, JetBrains 


“Nearly 20 years ago after I read Head First Java, \st edition, as a junior developer entering the Java world, 
the third edition still amazes me. Much has changed since then, including how people present tutorials. 
Head First Java, 3rd edition, is a valid alternative to today’s excellent video materials: It allows learners—ju- 
nior and senior alike—to quickly grasp concepts without losing them in details, but also without dumbing 
down the material, and with enough of the correct references for further reading, I especially enjoyed the 
material on Java streams, concurrency and NIO.” 

— Michael Simons, Java Champion and engineer at Neo4j, author of the German 
Spring Boot Buch reference 


“If you want to develop software using Java, this book 1s for you. Head First Java designs lots of straightfor- 
ward and elegant examples to help the readers understand and learn how to use Java to create software. 
This is a great first book for anyone who wants to be a Java programmer.” 

— Sanhong Li, Alibaba Cloud 


More praise for Head First Java, 3rd Edition 


“Head First fava is a technical book that doesn’t feel like a technical book: it’s fun, casual, and full of worldly analo- 


gies that introduce complex concepts in a very smooth way. It’s the perfect introduction to the rich and vast Java 
ecosystem.” 


— Abraham Marin-Perez, Principal Consultant, Cosota Team 


“For those who like a little whimsy and humor with their “work”, I can think of no better book for learning Java 
than Head First Java, 3rd edition. Practical and playful, educational and engaging, it’s the perfect guide for new 
developers looking to hit the ground running.” 


— Marc Loy, trainer, author of Smaller C, and co-author of Learning Java and Java Swing 


Praise for earlier editions of Head First Java, 
and for other books coauthored by Kathy and Bert 


“Kathy and Bert’s Head First Java transforms the printed page into the closest thing to a GUI you've ever seen. Ina 


wry, hip manner, the authors make learning Java an engaging ‘what’re they gonna do next?’ experience.” 
— Warren Keuffel, Software Development Magazine 


“...the only way to decide the worth of a tutorial is to decide how well it teaches. Head First Java excels at teaching. 


OK, I thought it was silly...then I realized that I was thoroughly learning the topics as I went through the book.... 
The style of Head First Java made learning, well, easier.” 


— slashdot (honestpuck’s review) 


“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, Head First 
Java covers a huge amount of practical matters that other texts leave as the dreaded “exercise for the reader...” It’s 


clever, wry, hip and practical—there aren’t a lot of textbooks that can make that claim and live up to it while also 
teaching you about object serialization and network launch protocols.” 


—Dr. Dan Russell, Director of User Sciences and Experience Research IBM Almaden 
Research Center (and teaches Artificial Intelligence at Stanford University) 


“Tt’s fast, irreverent, fun, and engaging. Be careful—you might actually learn something!” 


—Ken Arnold, former Senior Engineer at Sun Microsystems and coauthor (with James 
Gosling, creator of Java) of The Java Programming Language 


“Java technology is everywhere. If you develop software and haven’t learned Java, it’s definitely time to dive in— 
Head First.” 
—Scott McNealy, former Sun Microsystems Chairman, President, and CEO 


“Head First fava is like Monty Python meets the gang of four...the text is broken up so well by puzzles and stories, 
quizzes and examples, that you cover ground like no computer book before.” 
—Douglas Rowe, Columbia Java Users Group 


“Read Head First Java and you will once again experience fun in learning...For people who like to learn new 
programming languages, and do not come from a computer science or programming background, this 
book is a gem... This is one book that makes learning a complex computer language fun.” 

— Judith Taylor, Southeast Ohio Macromedia User Group 


“If you want to learn Java, look no further: welcome to the first GUI-based technical book! This perfectly- 
executed, ground-breaking format delivers benefits other Java texts simply can’t...Prepare yourself for a 
truly remarkable ride through Java land.” 

— Neil R. Bauman, Captain and CEO, Geek Cruises 


“Twas ADDICTED to the book’s short stories, annotated code, mock interviews, and brain exercises.” 
— Michael Yuan, author of Enterprise J2ME 


“Head First Java gives new meaning to their marketing phrase “There’s an O’Reilly for that.’ I picked this 
up because several others I respect had described it in terms like ‘revolutionary’ and described a radically 
different approach to the textbook. They were (are) right...In typical O’Reilly fashion, they’ve taken a 
scientific and well considered approach. The result is funny, irreverent, topical, interactive, and brilliant... 
Reading this book 1s like sitting in the speakers lounge at a conference, learning from—and laughing 
with—peers...If you want to UNDERSTAND Java, go buy this book.” 

—Andrew Pollack, www.thenorth.com 


“This stuff is so fricking good it makes me wanna WEEP! I’m stunned.” 
— Floyd Jones, Senior Technical Writer /Poolboy, BEA 


“T feel like a thousand pounds of books have just been lifted off of my head.” 
— Ward Cunningham, inventor of the Wiki and founder of the Hillside Group 


“T laughed, I cried, it moved me.” 
— Dan Steinberg, Editor-in-Chief, java.net 


“My first reaction was to roll on the floor laughing. After I picked myself up, I realized that not only is 
the book technically accurate, it is the easiest to understand introduction to design patterns that I have 
seen.” 

— Dr. Timothy A. Budd, Associate Professor of Computer Science at Oregon State 
University; author of more than a dozen books including C++ for Java Programmers 


“Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for practi- 
cal development strategies—gets my brain going without having to slog through a bunch of tired stale 
professor-speak.” 

— Travis Kalanick, founder of Scour and Red Swoosh, member of the MIT TR100 
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Breaking the Surface 


Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1.02, Java seduced programmers with its friendly syntax, object-oriented fea- 
tures, memory management, and best of all—the promise of portability. We'll take a quick dip 
and write some code, compile it, and run it. We're talking syntax, loops, branching, and what 
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A Trip to Objectville 


| was told there would be objects. In Chapter 1, we put all of our code in 
the main() method. That's not exactly object-oriented. So now we've got to leave that 
procedural world behind and start making some objects of our own. We'll look at what 
makes object-oriented (OO) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can improve your life. 
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Know Your Variables 


Variables come in two flavors: primitive and reference. 

There's gotta be more to life than integers, Strings, and arrays. What if you have a PetOwner 
object with a Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap 
the mysteries of Java types and look at what you can declare as a variable, what you can put 
in a variable, and what you can do with a variable. And we'll finally see what life is truly like 
on the garbage-collectible heap. 
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“T’d like a double mocha, no, make it an int.” 51 
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How Objects Behave 


State affects behavior, behavior affects state. We know that objects 
have state and behavior, represented by instance variables and methods. Now we'll look 
at how state and behavior are related. An object's behavior uses an object’s unique state. 

In other words, methods use instance variable values. Like, “if dog weight is less than 14 
pounds, make yippy sound, else...” Let’s go change some state! 


Remember: a class describes what an object knows and 
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Let’s put some muscle in our methods. You dabbled with variables, 
played with a few objects, and wrote a little code. But you need more tools. Like 
operators. And loops. Might be useful to generate random numbers. And turn 
a String into an int, yeah, that would be cool. And why don't we learn it all by building 


something real, to see what it’s like to write (and test) a program from scratch. Maybe a 


game, like Sink a Startup (similar to Battleship). 


Let’s build a Battleship-style game: “Sink a Startup” 
Developing a Class 

Writing the method implementations 

Writing test code for the SimpleStartup class 
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Using the Java Library 


Java ships with hundreds of prebuilt classes. You don't have to 
reinvent the wheel if you know how to find what you need from the Java library, commonly 


known as the Java API. You've got better things to do. If you're going to write code, you 


might as well write only the parts that are custom for your application. The core Java library 


is a giant pile of classes just waiting for you to use like building blocks. 


“Good to know there’s an ArrayLast in the java. 
util package. But by myself, how would I have 
Jigured that out?” 


- Julia, 31, hand model 


In our last chapter, we left you with the cliff-hanger. A bug. 
Wake up and smell the library 

Some things you can do with ArrayList 

Comparing ArrayList to a regular array 

Let’s build the REAL game: “Sink a Startup” 

Prep code for the real StartupBust class 

The final version of the Startup class 

Super Powerful Boolean Expressions 

Using the Library (the Java API) 

Exercises 
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Better Living in Objectville 


Plan your programs with the future in mind. what if you could write 
code that someone else could extend, easily? What if you could write code that was flexible, for 
those pesky last-minute spec changes? When you get on the Polymorphism Plan, you'll learn the 
5 steps to better class design, the 3 tricks to polymorphism, the 8 ways to make flexible code, 
and if you act now—a bonus lesson on the 4 tips for exploiting inheritance. 
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Serious Polymorphism 


Inheritance is just the beginning. To exploit polymorphism, we need 
interfaces. We need to go beyond simple inheritance to flexibility you can get only by 
designing and coding to interfaces. What’s an interface? A 100% abstract class. What’s an 
abstract class? A class that can’t be instantiated. What's that good for? Read the chapter... 
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Life and Death of an Object 


Objects are born and objects die. You're in charge. You decide when and 
how to construct them. You decide when to abandon them. The Garbage Collector (gc) 


reclaims the memory. We'll look at how objects are created, where they live, and how to 


keep or abandon them efficiently. That means we'll talk about the heap, the stack, scope, 


constructors, super constructors, null references, and gc eligibility. 
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Risky Behavior 


Stuff happens. The file isn’t there. The server is down. No matter how good a 


programmer you are, you can't control everything. When you write a risky method, you 


need code to handle the bad things that might happen. But how do you know when a 


method is risky? Where do you put the code to handle the exceptional situation? In this 


chapter, we're going to build a MIDI Music Player that uses the risky JavaSound API, so we 


better find out. 
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Work on Your Swing 
Swing is easy. Unless you actually care where everything goes. Swing code looks 


easy, but then compile it, run it, look at it, and think, “hey, that’s not supposed to go there.” 
The thing that makes it easy to code is the thing that makes it hard to contro/—the Layout 
Manager. But with a little work, you can get layout managers to submit to your will. In 
this chapter, we'll work on our Swing and learn more about widgets. 
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needs to save state, you can do it the hard way, interrogating each object, painstakingly 
writing the value of each instance variable. Or, you can do it the easy OO way—you simply 
freeze-dry the object (serialize it) and reconstitute (deserialize) it to get it back. 
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Make a Connection 


Connect with the outside world. It’s easy. All the low-level networking 
details are taken care of by classes in the java.net library. One of Java's best features is 

that sending and receiving data over a network is really just I/O with a slightly different 
connection stream at the end of the chain. In this chapter we'll make client sockets. We'll 
make server sockets. We'll make clients and servers. Before the chapter's done, you'll have a 
fully functional, multithreaded chat client. Did we just say multithreaded? 
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Appendix B 


The top ten-ish topics that didn’t make it into the rest of the 


book. We can't send you out into the world just yet. We have a few more things for you, 


but this is the end of the book. And this time we really mean it. 


#11 JShell Java REPL) 

#10 Packages 

#9 Immutability in Strings and Wrappers 

#8 Access levels and access modifiers (who sees what) 
#7 Varargs 

#6 Annotations 

#5 Lambdas and Maps 

#4 Parallel Streams 

#3 Enumerations (also called enumerated types or enums) 
#2 Local Variable Type Inference (var) 

#1 Records 
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Who is this book for? 


If you can answer “yes” to all of these: wave 
- - This is NOT a reference 


@) Have you done some programming? book. Head First Javaisa 
book designed for learning, 
@) Do you want to learn Java? not an encyclopedia of 


Java facts. 


Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 


this book is for you. 


Who should probably back away from this book? 


If you can answer “yes” to any one of these: 


@) Is your programming background limited 
to HTML only, with no scripting language 
experience? 
(If you’ve done anything with looping or if/then logic, 
you'll do fine with this book, but HTML tagging 
alone might not be enough.) 


@ Are you a kick-butt C++ programmer 
looking for a reference book? 


® Are you afraid to try something different? 
Would you rather have a root canal than 
mix stripes with plaid? Do you believe 
that a technical book can’t be serious if 
there’s a picture of a duck in the memory 
management section? 


this book is no# for you. 


C t, f m m ina: 
es a : saints ng: who took out the part about how 


anyone with a valid credit card? 
about that “Give the 6; weit Caras And what 
disused... bog: e Gift of Java holiday Promotion we 
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We know what youre thinking 


“How can this be a serious Java programming book?” 


“What’s with all the graphics?” 


“Can I actually dearn it this way?” 


“Do I smell pizza?” 


And we know what your brain is thinking 


Your brain craves novelty. It’s always searching, scanning, wazting for 
something unusual. It was built that way, and it helps you stay alive. 


Today, you’re less likely to be a tiger snack. But your brain’s still looking. You 
just never know. 


So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real job—recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important” 
filter. 


How does your brain Anow what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you, what happens inside your head? 


Neurons fire. Emotions crank up. Chemicals surge. 


Great. Only 
And that’s how your brain knows... ae ee 


This must be important! Don’t forget it! yinks 
‘ : ; : ‘ an © 
But imagine you're at home, or in a library. It’s a safe, warm, tiger-free zone. Yor“ ae iq worth 0 


You’re studying. Getting ready for an exam. Or trying to learn some tough dace 
technical topic your boss thinks will take a week, ten days at the most. “ ~ 


Just one problem. Your brain’s trying to do you a big favor. It’s trying to 


make sure that this obviously non-important content doesn’t clutter up 
scarce resources. Resources that are better spent storing the really 
big things. Like tigers. Like the danger of fire. Like how you should 


never again snowboard in shorts. 


And there’s no simple way to tell your brain, “Hey, brain, thank you 
very much, but no matter how dull this book is, and how little Pm 
registering on the emotional richter scale right now, I really do want 
you to keep this stuff around.” 
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how to use this book 


we think of a Head First Java reader as a learner. 


So what does it take to learn something? First, you have to getit, then make sure 
you don’t forget it. It’s not about pushing facts into your head. Based on the 
latest research in cognitive science, neurobiology, and educational psychology, 
learning takes a lot more than text on a page. We know what turns your brain on. 


Some of the Head First learning principles: 


needs to call a 


goa meth 
Make it visual. Images are far more memorable than words piri on the RMI Vania 
é . eri 
alone, and make learning much more effective (up to 89% . 
improvement in recall and transfer studies). It also makes doCalc() j 


things more understandable. Put the words within 


or near the graphics they relate to, rather than on the 


return value 


bottom or on another page, and learners will be up to twice 


as likely to solve problems related to the content. z= 


Usea conversational and personalized style. In recent studies, 


Tt really sucks to be an students performed up to 40% better on post-learning tests if the content spoke 


abstract method. You 
don't have a body. 


directly to the reader, using a first-person, conversational style rather than taking 


a formal tone. Tell stories instead of lecturing. Use casual language. Don't take 


yourself too seriously. Which would you pay more attention to: a stimulating 


dinner party companion, or a lecture? 


Get the learner to think more deeply. In other words, unless 
you actively flex your neurons, nothing much happens in your head. 


Does it make sense to 
say Tub IS-A Bathroom? 
Bathroom IS-A Tub? Or is 
it a HAS-A relationship? 


ie) 

tC) 

= 
ae 


A reader has to be motivated, engaged, curious, and inspired to 


4 i solve problems, draw conclusions, and generate new knowledge. 

= \ { And for that, you need challenges, exercises, thought- 

Ss \h. : : sia ; ; 
= void roam() ; provoking questions, and activities that involve both sides 


of the brain and multiple senses. 


nett vie = 
Get—and keep—the reader’s attention. We've all » 
had the “I really want to learn this but | can’t stay awake past : : 
page one” experience. Your brain pays attention to things that are out wai y 


of the ordinary, interesting, strange, eye-catching, unexpected. Learning a new, 


tough, technical topic doesn’t have to be boring. Your brain will learn much more quickly if it’s not. 


Touch their emotions. We now know that your ability to remember something is largely 


dependent on its emotional content. You remember what you care about. You remember when 


you feel something. No we're not talking heart-wrenching stories about a boy and his dog. 


We're talking emotions like surprise, curiosity, fun, “what the...?", and the feeling of “I Rule!” 


that comes when you solve a puzzle, learn something everybody else thinks is hard, or realize 


you know something that “I’m more technical than thou" Bob from engineering doesn't. 
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Metacognition: thinking about thinking 


I wonder how I 

can trick my brain 
into remembering this 
stuff... 


If you really want to learn, and you want to learn more quickly and more deeply, pay 
attention to how you pay attention. Think about how you think. Learn how you learn. 


Most of us did not take courses on metacognition or learning theory when we were 
growing up. We were expected to learn, but rarely taught to learn. oO 


But we assume that if you’re holding this book, you want to learn Java. And you probably 
don’t want to spend a lot of time. 


To get the most from this book, or any book or learning experience, take responsibility for 
your brain. Your brain on ¢hat content. 


The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 

Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 


z= 


So just how DO you get your brain to treat Java like 
it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The slow way is about 
sheer repetition. You obviously know that you ave able to learn and remember even the 
dullest of topics, if you keep pounding on the same thing. With enough repetition, your 
brain says, “This doesn’t feel important to him, but he keeps looking at the same thing over 
and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording, 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing 1s, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning, 
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Here's what WE did: 


We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really 7s worth 1024 words. And when text and pictures work together, 
we embedded the text zm the pictures because your brain works more effectively when the 
text 1s within the thing the text refers to, as opposed to in a caption or buried in the text 
somewhere. 


We used repetition, saying the same thing in different ways and with different media 
types, and multiple senses, to increase the chance that the content gets coded into more than 
one area of your brain. 


We used concepts and pictures in unexpected ways because your brain 1s tuned for 
novelty, and we used pictures and ideas with at least some emotional content, because your 
brain is tuned to pay attention to the biochemistry of emotions. That which causes you to 
feel something is more likely to be remembered, even if that feeling is nothing more than a 
little humor, surprise, or interest. 


We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you're reading. 


We included more than 50 exercises because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-do-able, because that’s what most people prefer. 


We used multiple learning styles, because you might prefer step-by-step procedures, 
while someone else wants to understand the big picture first, while someone else just wants 
to see a code example. But regardless of your own learning preference, everyone benefits 
from seeing the same content represented in multiple ways. 


We include content for both sides of your brain, because the more of your brain 

you engage, the more likely you are to learn and remember, and the longer you can stay 
focused. Since working one side of the brain often means giving the other side a chance to 
rest, you can be more productive at learning for a longer period of time. 


And we included stories and exercises that present more than one point of view, 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 


We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work 
at something (just as you can’t get your Jody in shape by watching people at the gym). But 
we did our best to make sure that when you’re working hard, it’s on the right things. That 
you’re not spending one extra dendrite processing a hard-to-understand example, or 
parsing difficult, jargon-laden, or extremely terse text. 


We used an 80/20 approach. We assume that if you’re going for a PhD in Java, this won’t 
be your only book. So we don’t talk about everything. Just the stuff you'll actually use. 
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BE the Compiler 


BULLET POINTS 


Cut this out and stiek it 


i as refrigerator. 


Slow down. The more you understand, 
the less you have to memorize. 


Don’t just read. Stop and think. When the 
book asks you a question, don’t just skip to the 
answer. Imagine that someone really zs asking 
the question. The more deeply you force your 
brain to think, the better chance you have of 
learning and remembering. 


Do the exercises. Write your own notes. 


We put them in, but if we did them for you, 
that would be like having someone else do 
your workouts for you. And don’t just look at 
the exercises. Use a pencil. There’s plenty of 
evidence that physical activity while learning 
can increase the learning, 


Read the “There are No Dumb Questions” 
That means all of them. They’re not optional 
sidebars—they’re part of the core content! 
Sometimes the questions are more useful than 

the answers. 


Don’t do all your reading in one place. 
Stand up, stretch, move around, change chairs, 
change rooms. It'll help your brain feel something, 
and it keeps your learning from being too 
connected to a particular place. 


Make this the last thing you read before 


bed. Or at least the last challenging thing. 


Part of the learning (especially the transfer to 
long-term memory) happens after you put the 
book down. Your brain needs time on its own, to 
do more processing. If you put in something new 
during that processing time, some of what you 
just learned will be lost. 


what doesn’t. Try new things. 


© 
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Here's what YOU can do to bend your 
brain into submission 


So, we did our part. The rest is up to you. These tips are a starting 
point; Listen to your brain and figure out what works for you and 


Drink water. Lots of it. 


Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 


Talk about it. Out loud. 

Speaking activates a different part of the brain. 
If you’re trying to understand something or 
increase your chance of remembering it later, say 
it out loud. Better still, try to explain it out loud 
to someone else. You'll learn more quickly, and 
you might uncover ideas you hadn’t known were 
there when you were reading about it. 


Listen to your brain. 


Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim the 
surface or forget what you just read, it’s time for a 
break. Once you go past a certain point, you won’t 
learn faster by trying to shove more in, and you 
might even hurt the process. 


Feel something! 


Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke is 
sill better than feeling nothing at all. 


Type and run the code. 


Type and run the code examples. Then you can 
experiment with changing and improving the code 
(or breaking it, which is sometimes the best way to 
figure out what’s really happening). Most of the 
code, expecially long examples and Ready-Bake 
Code, are at https://oreil. ly /hffava_3e_examples. 
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What you need for this book: 


You do not need any other development tool, such as an Integrated 
Development Environment (IDE). We strongly recommend that you 
not use anything but a basic text editor until you complete this book. 
An IDE can protect you from some of the details that really matter, so 
you're much better off learning from the command line and then, once 
you really understand what’s happening, move to a tool that automates 
some of the process. 


-—— SETTING UP JAVA 


This book assumes you’re 
using Java 11 (with the 
exception of Appendix B). 
However, if you’re using 
Java 8, you will find most 
of the code still works. 


If there’s discussion of a 
feature from a version of 
Java higher than Java 8, 


the required version will 
be mentioned. 


Because versions are moving quickly and advice on the right JDK to use may change, we’ve 
put detailed instructions on how to install Java into the code samples project online: 


https://oreil.ly/hfJava_install 
This is a simplified version. 
If you don’t know which version of Java to download, we recommend using Java 17. 


There are many free builds of OpenJDK available (the open source version of Java). We 
suggest the community-supported Eclipse Adoptium JDK at https://adoptium.net. 


The JDK includes everything you need to compile and run Java. The JDK does not include the 
API documentation, and you need that! Download the Java SE API documentation. You can 


also access the API docs online without downloading them, but trust us, it’s worth the download. 


You need a text editor. Virtually any text editor will do (vi, emacs), including the GUI ones that 
come with most operating systems. Notepad, Wordpad, TextEdit, etc., all work, as long as 
you're using plain text (not rich text) and make sure they don’t append a “txt” on to the end of 
your source code (“java”) file. 


Once you've downloaded and unpacked/installed/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable that points to the bin 
directory inside the main Java directory. The bin directory is the one you need a PATH to, so 
that when you type: 


% JjJavac 


at the command line, your terminal will know how to find the javac compiler. 


Note: if you have trouble with your installation, we recommend you go to javaranch.com and 
join the Java-Beginning forum! Actually, you should do that whether you have trouble or not. 


The code from this book is available at Attps://oreil. ly /hffava_3e_examples. 
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Last-minute things you need to know: 


This is a learning experience, not a reference book. We deliberately stripped out 
everything that might get in the way of learning whatever it is we’re working on 
at that point in the book. And the first time through, you need to begin at the 
beginning, because the book makes assumptions about what you’ve already seen 
and learned. 


We use simple UML-like diagrams. 


If we’d used pure UML, you'd be seeing something that looks like Java, but with 
syntax that’s just plain wrong. So we use a simplified version of UML that doesn’t 
conflict with Java syntax. If you don’t already know UML, you won’t have to 
worry about learning Java and UML at the same time. 


We don’t worry about organizing and packaging your own 
code. 


In this book, you can get on with the business of learning Java, without stressing 
over some of the organizational or administrative details of developing Java 
programs. You will, in the real world, need to know—and use—these details, but 
since building and deploying Java applications generally relies on third-party build 
tools like Maven and Gradle, we have assumed you'll learn those tools separately. 


The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 


One thing you need to know about the puzzles—they’re puzzles. As in logic puzzles, 
brain teasers, crossword puzzles, etc. The exercises are here to help you practice 
what you’ve learned, and you should do them all. The puzzles are a different story, 
and some of them are quite challenging in a puzzle way. These puzzles are meant 
for puzzlers, and you probably already know if you are one. If you’re not sure, we 
suggest you give some of them a try, but whatever happens, don’t be discouraged 
if you can’t solve a puzzle or if you simply can’t be bothered to take the time to 
work them out. 


The “Sharpen Your Pencil” exercises don’t all have 
answers. 

Not printed in the book, anyway. For some of them, there zs no right answer, and 
for the others, part of the learning experience for the Sharpen activities is for you 
to decide if and when your answers are right. 


The code examples are as lean as possible. 


It’s frustrating to wade through 200 lines of code looking for the two lines you 
need to understand. Most examples in this book are shown within the smallest 
possible context, so that the part you’re trying to learn is clear and simple. So 
don’t expect the code to be robust, or even complete. That’s your assignment for 
after you finish the book. The book examples are written specifically for learning 
and aren’t always fully functional. 


the intro 


ler Ao) 
se 3 wm 
We ied aux iM ry 


Dog 
size 
bark() 


eat() 
chaseCat() 


You should do ALL 


of the “Sharpen your 
pencil” activities 


Gedharpen your pencil 
~ iad 


you are here > = XXxi 


how to use this book 


Technical Reviewers for the 3rd Edition 


Abraham Marin—-Perez. 


Mare started with Java training at Sun Microsystems Abraham js a Java programmer, consultant, author, 

in the early days (shout-out to HotJava!) and never and public speaker with more than ten years of experience 
looked back. He authored a number of early Java books in a variety of industries. Originally from Valencia, 

and training courses, working with a wide variety of Spain, Abraham has built most of his career in London, 
companies across the US, Europe, and Asia along the UK, working with entities like JP Morgan or the United 
way. Most recently for O’Reilly, Marc authored Smaller Kingdom’s Home Office, frequently in collaboration 
Cand co-authored the fifth edition of Learning Java. with Equal Experts. ‘Thinking his experiences could be 
Currently in Ohio, Marc is a software developer and useful to others, Abraham became a Java news editor at 
maker specializing in microcontrollers. InfoQ, authored Real-World Maintainable Software, and co- 


authored Continuous Delivery in Java. He also helps run the 
London Java Community. Always the learner, Abraham is 
pursuing a degree in physics. 
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Other people to acknowledge for the 3rd Edition 


At O’Reilly: 


Huge thanks to Zan McQuade and Nicole Taché for enabling us to finally get this edition out! Zan, thanks 
for connecting Trisha back up to the Head First world, and Nicole, fantastic work driving us to get this done. 
Thanks to Meghan Blanchette, who left O’Reilly a hundred years ago, but it was she who introduced Bert 
and ‘Trisha back in 2014. 


Trisha would like to thank: 


Helen Stott 


Helen Scott, for providing frequent feedback on the new topics covered. She consistently stopped me 
from going too deep or assuming too much knowledge, and is a true champion of the learner. I can’t wait 
to start working even more closely with her on our next project. 


My team at JetBrains for their patience and encouragement: Dalia Abo Sheasha, for test-driving the 
lambdas and streams chapter, and Mala Gupta, for giving me exactly the mformation I needed about 
modern Java certifications. Extra special thanks to Hadi Hariri for all his support, always. 


The Friday Pub Lunch zformatoos, for tolerating lunchtime conversations on whatever aspect of Java I was 
trying to explain that day or week, and Alys, Jen, and Clare for helpmg me to figure out when to prioritize 
this book over family. Thanks to Holly Cummins for finding a last minute bug. 


Evie and Amy for the suggestions on how to improve the ice cream examples for Java’s Optional type. 
Thank you both for being genuinely interested in my progress, and for the spontaneous high-fives when you 


heard Id finished. 


None of this would have been possible without Israel Boza Rodriguez. You put up with me derailing 
important conversations like “what should we have for dimer?” with questions like “do you think 
CountDownLatch is too niche to teach beginner developers?” Crucially, you helped me to create space and 
time to work on the book, and regularly reminded me why I wanted to take on the project in the first place. 


Thank you to Bert and Kathy for bringing me on this journey. It was an honor to learn how to be a Head 
First author from the horse’s mouth, so to speak. 


Bert and Kathy would like to thank: 


Beth Robson and Eric Freeman, for their overall, ongoing, badass support of the Head First series. A 
special thanks to Beth for the many conversations we had discussing what new Java topics to teach and how 
to teach them. 


Paul Wheaton and the amazing moderators at CodeRanch.com (a.k.a. JavaRanch), for keepmg CodeRanch 
a friendly place for Java beginners. A special thanks to Campbell Ritchie, Jeanne Boyarsky, Stephan 
van Hulst, Rob Spoor, Tim Cooke, Fred Rosenberger, and Frits Walraven for their mvaluable input 
concerning what have been the truly important additions to Java since the 2nd edition. 


Dave Gustafson, for teaching me so much about software development and rock climbing, AND for great 
discussions concerning the state of programming. Eric Normand, for teaching us a little FP, and helping 
us figure out how to slip a few of the best ideas from FP into an OO book. Simon Roberts, for his ongoing 
and passionate teaching of Java to students all over the world. ‘Thanks to Heinz Kabutz and Venkat 
Subramaniam for helping us explore the nooks and crannies of Java Streams. 


Laura Baldwin and Mike Loukides, for their tireless support of Head First for all these years. 
Ron Bilodeau and Kristen Brown, for their outstanding, always patient and friendly support. 
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Technical Editors for the 2nd Edition 


Endless thanks to Jessica and Val for their hard work editing the 2nd 
edition. 


Jess works at Hewlett-Packard on the Self- 
Healing Services Team. She has a bachelor’s in 
computer engineering from Villanova University, 
has her SCJP 1.4 and SCWCD certifications, 
and is literally months away from receiving 
her master’s in software engineering at Drexel 
University (whew!). 


When she’s not working, studying, or motoring 
in her MINI Cooper S, Jess can be found 
fighting her cat for yarn as she completes her 
latest knitting or crochet project (anybody want a 
hat?). She is originally from Salt Lake City, Utah 
(no, she’s not Mormon...yes, you were too going 
to ask) and is currently living near Philadelphia 
with her husband, Mendra, and two cats: Chai 
and Sake. 


You can catch her moderating technical forums 
at javaranch.com. 
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Valentin's tie 


Valentin has a master’s degree in information 
and computer science from the Swiss Federal 
Institute of Technology in Lausanne (EPFL). 

He has worked as a software engineer with SRI 
International (Menlo Park, CA) and as a principal 
engineer in the Software Engineering Laboratory of 
EPFL. 


Valentin is the cofounder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture solutions. 


His research and development interests include 
aspect-oriented technologies, design and 
architectural patterns, web services, and software 
architecture. Besides taking care of his wife, 
gardening, reading, and doing some sport, Valentin 
moderates the SCBCD and SCDJWS forums at 
Javaranch.com. He holds the SCJP, SCJD, SCBCD, 
SCWCD, and SCDJWS certifications. He has also 
had the opportunity to serve as a co-author for 


Whizlabs SCBCD Exam Simulator. 


(We’re still in shock from seeing him in a te.) 
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Jef Cumps 
Corey MeGlore 


Our biggest thanks to Mike Loukides at O’Reilly, for taking a chance 
on this, and helping to shape the Head First concept into a book (and 
series). As this second edition goes to print there are now five Head First 
books, and he’s been with us all the way. To Tim O’Reilly, for his 
willingness to launch into something completely new and different. ‘Thanks 
to the clever Kyle Hart for figuring out how Head First fits into the 
world and for launching the series. Finally, to Edie Freedman for 
designing the Head First “emphasize the head” cover. 


Our intrepid beta testers and reviewer team: 


Our top honors and thanks go to the director of our javaranch tech 
review team, Johannes de Jong. This is your fifth time around with us 
on a Head First book, and we’re thrilled you’re still speaking to us. Jeff 
Cumps is on his third book with us now and relentless about finding 
areas where we needed to be more clear or correct. 


Corey McGlone, you rock. And we think you give the clearest 
explanations on JavaRanch. You'll probably notice we stole one or two 
of them. Jason Menard saved our technical butts on more than a 
few details, and Thomas Paul, as always, gave us expert feedback and 
found the subtle Java issues the rest of us missed. Jane Griscti has her 
Java chops (and knows a thing or two about writing), and it was great to 


Thomas Paul 


have her helping on the new edition along with long-time javarancher 
Barry Gaunt. 


Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chris Jones, John Nyquist, James Cubeta, Terri 
Cubeta, and Ira Becker gave us a ton of help on the first edition. 


Special thanks to a few of the Head Firsters who’ve been helping us Mavilym de 
from the beginning: Angelo Celeste, Mikalai Zaikin, and Queiroz. 
Thomas Duff (twduff.com). And thanks to our terrific agent, David 
Rogelberg of StudioB (but seriously, what about the move rights?) 


James Cubeta Terri Cubeta John Nyquist Chris Jones 
Ira Becke, 


Rodney , 
Woodrutt 
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still more acknowledgments 


Just when you thought there wouldn't be any 
more acknowledgments* 


More Java technical experts who helped out on the first edition (in pseudo-random 
order): 


Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, Shweta 
Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, Sunil Palicha, 
Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, Mikalai Zaikin, John 
Zoetebier, Jim Pleger, Barry Gaunt, and Mark Dielen. 


The first edition puzzle team: 


Dirk Schreckmann, Mary “JavaCross Champion” Leners, Rodney J. Woodruff, Gavin Bong, and 
Jason Menard. Javaranch is lucky to have you all helping out. 


Other co-conspirators to thank: 


Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 

Solveig Haugland, mistress of J2EE and author of Dating Design Patterns. 

Authors Dori Smith and Tom Negrino (backupbrain.com), for helping us navigate the tech 
book world. 


Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls™ to finish this on time. 


Sherry Dorris, for the things that really matter. 


Brave early adopters of the Head First series: 


Joe Litton, Ross P. Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen Lepp, 
Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan Oliphant, 
Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, Bob Thomas, and 
Mike Bibby (the first). 


*The large number of acknowledgments is because we’re testing the theory that everyone mentioned in 
a book acknowledgment will buy at least one copy, probably more, what with relatives and everything. If 
you'd like to be in the acknowledgment of our next book, and you have a large family, write to us. 
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Breaking the Surface 


Come on, the 
water's great! We'll 
dive right in and write some code, 
then compile and run it. We're 

talking syntax, looping and branching, 
and a look at what makes Java so 
cool. You'll be coding in no 
time. 


Java takes you to new places. From its humble release to the public as the (wimpy) 
version 1.02, Java seduced programmers with its friendly syntax, object-oriented features, memory 
management, and best of all—the promise of portability. The lure of write-once/run-anywhere 
is just too strong. A devoted following exploded, as programmers fought against bugs, limita- 

tions, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 

Java, you’re lucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial application to work. But you, why, you get to ride the sleeker, faster, 
easier-to-read-and-write Java of today. 
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the way Java works 


The way Java works 


The goal is to write one application (in this 
example, an interactive party invitation) and have 
it work on whatever device your friends have. 


source code for 


the interactive 


party invitation. 


Source 


Create a source 
document. Use an 
established protocol 
(in this case, the Java 
language). 
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aload_0 
4 invokespecial 
#1 <Method av 


fang. Object Pp 


Compiler 


2 | 


Run your document 
through a source code 
compiler. The compiler 
checks for errors and 
won't let you compile 
until it’s satisfied that 
everything will run 
correctly. 


Method Party() 


0 aload_0 


1 invokespecial # 
<Method java.lang. 
Object()> 


4 return 


Output 
(code) 


3 | 


The compiler creates a 
new document, coded 
into Java bytecode. 

Any device capable of 
running Java will be able 
to interpret/translate 
this file into something 
it can run. The compiled 
bytecode is platform- 
independent. 


Virtual 
Machines 


o 


Your friends all have a 
Java virtual machine 
(JVM), implemented in 
software, running inside 
their electronic gadgets. 
When your friends run 
your program, the virtual 
machine reads and runs 
the bytecode. 


What you'll do in Java 


You'll type a source code file, compile it using 
the javac compiler, and then run the compiled 
bytecode on a Java virtual machine. 


import java.awt.*; 
import java.awt.event.*; 


Class Party { 

public void buildInvite() { 
Frame f = new Frame(); 
Label | = new Label("Party at Tim's"); 
Button b = new Button("You bet"); 
Button c = new Button("Shoot me"); 
Panel p = new Panel(); 

p.add(|); 

} / more code here... 


} 


Source 


Type your source code. 


Save as: Party.java 


File Edit Window Help Plead 


Method Party() 
0 aload_0 


Sjavac Party.java 


1 invokespecial #1 <Method 
java.lang.Object()> 


4 return 


Method void buildInvite() 
Compiler 


0 new #2 <Class java.awt.Frame> 


2 . 
4 invokespecial #3 <Method 


java.awt.Frame()> 


Compile the Party.java 
file by running javac 
(the compiler application). 
If you don't have errors, 
you'll get a second docu- 
ment named Party.class. 


Output 
(code) 


3 | 


Compiled code: Party.class 


The compiler-generated 
Party.class file is made up 
of bytecodes. 


(Note: this is NOT meant to be a tutorial... 
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Sjava Party 


e090 


Party at Tim's! 


eau shoot we) 


Virtual 
Machines 


o 


Run the program by 
starting the Java Virtual 
Machine (JVM) with the 
Party.class file. The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 
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history of Java 


A very brief history of Java 


Java was initially released (some would say “escaped”), on January 23, 1996. It’s over 25 years old! In 
the first 25 years, Java as a language evolved, and the Java API grew enormously. The best estimate we 
have is that over 17 gazillion lines of Java code have been written in the last 25 years. As you spend time 
programming in Java, you will most certainly come across Java code that’s quite old, and some that’s 
much newer. Java is famous for its backward compatibility, so old code can run quite happily on new 


JVMs. 


In this book we’ll generally start off by using older coding styles (remember, you’re likely to encounter 
such code in the “real world’), and then we'll introduce newer-style code. 


In a similar fashion, we will sometimes show you older classes in the Java API, and then show you 
newer alternatives. 


I've heard that 
Java isn't very fast 
compared to compiled 
languages like C and 
Rust. 


Speed and memory usage 


When Java was first released, it was slow. But soon after, the 
HotSpot VM was created, as were other performance enhanc- 
ers. While it’s true that Java isn’t the fastest language out there, 
it’s considered to be a very fast language—almost as fast as 
languages like C and Rust, and much faster than most other 
languages out there. 


Java has a magic super-power—the JVM. The Java Virtual 
Machine can optimize your code while it’s running, so it’s possible 
to create very fast applications without having to write special- 
ized high-performance code. 


But—full disclosure—compared to C and Rust, Java uses a lot 
of memory. 
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G harpen your pencil 
IN ———> Answers on page 6. 


Try to guess what each line of code is doing... 
(answers are on the next page). 


Look how easy it 
is to write Java 


int size = 27; declare an integer variable named ‘size’ and give it the value 27 


String name = "Fido"; 


Dog myDog = new Dog(name, size); 


size - 5; 


if (x < 15) myDog.bark(8); 


while (x > 3) { 


if x (value of 22, is less than 15, tell the dog to bark 8 times 


myDog.play(); 


int[] numList = {2, 4, 6, 8}; 


System.out.print("Hello"); 


print out “Hello”... probably at the command line 


System.out.print("Dog: + name); 


String num = "8"; 


int z = Integer.parseInt(num) ; 


try { 


readTheFile("myFile.txt"); 


} 


catch (FileNotFoundException ex) { 


System.out.print("File not found."); 


Q: The naming conventions for Java’s versions are 
confusing. There was JDK 1.0, and 1.2, 1.3, 1.4, then a jump 
to J2SE 5.0, then it changed to Java 6, Java 7, and last time 
I checked, Java was up to Java 18. What's going on? 


A: The version numbers have varied a lot over the last 
25+ years! We can ignore the letters (J2SE/SE) since these 
are not really used now. The numbers are a little more 
involved. 

Technically Java SE 5.0 was actually Java 1.5. Same for 6 
(1.6), 7 (1.7), and 8 (1.8). In theory, Java is still on version 


1.x because new versions are backward compatible, all the 
way back to 1.0. 
However, it was a bit confusing having a version number 
that was different to the name everyone used, so the 
official version number from Java 9 onward is just the 
number, without the “1” prefix; i.e., Java 9 really is version 
9, not version 1.9. 
In this book we'll use the common convention of 1.0-1.4, 
then from 5 onward we'll drop the “1” prefix. 
Also, since Java 9 was released in September 2017, there's 
been a release of Java every six months, each with a new 
“major” version number, so we moved very quickly from 9 
to 18! 
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G@qdharpen your pencil answers 
oN 


Look how easy it 
is to write Java 


int size = 27; 
String name = "Fido"; 

Dog myDog = new Dog(name, size); 
xX = size - 5; 


if (x < 15) myDog.bark(8); 


while (x > 3) { 


myDog.play(); 


int[] numList = {2, 4, 6, 8}; 
System.out.print("Hello"); 


System.out.print("Dog: 
"gn, 


+ name); 
String num = 


int z = Integer.parseInt(num); 


try { 
readTheFile("myFile.txt"); 


} 
catch (FileNotFoundException ex) { 


System.out.print("File not found."); 
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Don’t worry about whether you understand any of this yet! 
Everything here is explained in great detail in the book (most 
within the first 40 pages). If Java resembles a language you've 
used in the past, some of this will be simple. If not, don’t worry 
about it. We'll get there... 


declare an integer variable named ‘size’ and give it the value 27 


declare a string of characters variable named ‘name’ and give it the value “Fido” 


declare a new Dog variable ‘myDog and make the new Dog using ‘name’ and ‘size’ 


subtract 5 from 27 (value of ‘size’) and assign it to a variable named ‘x’ 


if x (value of 22.) is less than 15, tell the doo to bark 8 times 


keep looping as long as X Is greater than 3... 


tell the dog to play (whatever THAT means to a dog...) 


this looks like the end of the loop -- everything in { } is done in the loop 


declare a list of integers variable ‘numList, and put 2,4,6,8 into the list. 


print out “Hello”... probably at the command line 


print out “Dos: Fido” (the value of ‘name’ is “Fido’) at the command line 


declare a character string variable ‘num’ and give it the value of “8” 


convert the string of characters “8” into an actual numerit value 8 


try to do something...maybe the thing we're trying isn’t guaranteed to work... 


read a text file named “myFiletxt” (or at least TRY to read the file...) 


must be the end of the “things to try’, so | Quess you tould try many things... 


this must be where You find out if the thing You tried didn't work... 


if the thing we tried failed, print “File not found” out at the command line 


looks like everything in the { } is what to do if the ‘bry’ didn’t work... 


Code structure in Java 


method 1 


statement 


merhed 2 


statement 
statement 


In a source file, put a class. 


In a class, put methods. 


In a method, put statements. 


What goes ina 
source file? 


A source code file (with the java 
extension) typically holds one class 
definition. The class represents a 
prece of your program, although a 
very tiny application might need 
just a single class. The class must go 
within a pair of curly braces. 


What goes ina 
class? 


A class has one or more methods. 
In the Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared zside a class (in 
other words, within the curly braces 
of the class). 


What goes ina 
method? 


Within the curly braces of a 
method, write your instructions for 
how that method should be per- 
formed. Method code is basically a 
set of statements, and for now you 
can think of a method kind of like a 
function or procedure. 
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public class Dog { 


public class Dog { 


void bark() { 


method 


public class Dog { 
void bark() { 
statementl1 ; 
statement2; 
} 


‘statements 
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a Java class 


Anatomy of a class 


When the JVM starts running, it looks for the class you give it at the command 
line. Then it starts looking for a specially written method that looks exactly like: 


public static void main (String[] args) { 
// your code goes here 
} 


Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class, and at least one 
main method (not one main per class; just one main per application). 


This is a The name of Opening curly 
Public so i all class (duh) this ¢lass brace of the class 
can access ' 


SECC SLecr eer 
class My This method must * given 
The return type. an array of Strings, and the 


(We'll cover this oid means there's The name of array wi 
m Y will be ealled ‘avas’ 
one later.) no return value. his method a 


\ 
weciegti aap 
Syatan ok PELRET Rade TG] eat 


This says print to standard output 
(defaults to command line) 


FL clesng brace of the main method 


Ba oie brace of the MyFirstApp class 


The String, You 
want to print 


Don't worry about memorizing anything right now... 
this chapter is just to get you started. 
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Writing a class with a mainQ 


In Java, everything goes in a class. You'll type your source code file (with a java 
extension), then compile it into a new class file (with a .class extension). When 
you run your program, you’re really running a class. 


Running a program means telling the Java Virtual Machine (JVM) to “Load the 
MyFirstApp class, then start executing its main () method. Keep running 
til all the code in main is finished.” 


In Chapter 2, A Tp to Objectville, we go deeper into the whole class thing, but for 
now, the only question you need to ask is, how do I write Java code so that 
at will run? And it all begins with main(). 


The main() method is where your program starts running, 


No matter how big your program is (in other words, no matter how many classes 
your program uses), there’s got to be a main() method to get the ball rolling. 


@ Save 


MyFirstApp. java 


2] Compile } 


javac MyFirstApp.java 


p 
string{]) 


MyFirstApp.class 
—- @ Run 


Sjava MyFirstApp 


oid main (java.lang, 


java MyFirstApp 


I Rule! 


The World 


public class MyFirstApp { 
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public static void main (String[] args) { 
System.out.println("I Rule!") ; 
System.out.println("The World") ; 


the compiler and the JVM 


Fireside Chats 


The Java Virtual Machine 

What, are you kidding? HELLO. I am Java. I’m 
the one who actually makes a program run. The 
compiler just gives you a file. That’s it. Just a file. 
You can print it out and use it for wallpaper, kin- 
dling, lining the bird cage, whatever, but the file 
doesn’t do anything unless I’m there to run it. 


And that’s another thing, the compiler has no 
sense of humor. Then again, if you had to spend 
all day checking nitpicky little syntax violations... 


I’m not saying you’re, like, completely useless. But 
really, what is it that you do? Seriously. I have no 
idea. A programmer could just write bytecode by 
hand, and Id take it. You might be out of a job 
soon, buddy. 


(I rest my case on the humor thing.) But you still 
didn’t answer my question, what do you actually 


do? 


Tonight’s Talk: The compiler and 
the JVM battle over the question, 
“Who’s more important?” 


The Compiler 


I don’t appreciate that tone. 


Excuse me, but without me, what exactly would 
you run? There’s a reason Java was designed to use 
a bytecode compiler, for your information. If Java 
were a purely interpreted language, where—at 
runtime—the virtual machine had to translate 
straight-from-a-text-editor source code, a Java 
program would run at a ludicrously glacial pace. 


Excuse me, but that’s quite an ignorant (not to 
mention arrogant) perspective. While it zs true 
that—theoretically—you can run any properly 
formatted bytecode even if it didn’t come out of 

a Java compiler, in practice that’s absurd. A pro- 
grammer writing bytecode by hand is like paint- 
ing pictures of your vacation instead of taking 
photos—sure, it’s an art, but most people prefer to 
use their time differently. And I would appreciate 
it if you would not refer to me as “buddy.” 


Remember that Java is a strongly typed language, 
and that means I can’t allow variables to hold data 
of the wrong type. This is a crucial safety feature, 
and I’m able to stop the vast majority of viola- 
tions before they ever get to you. And I also— 


The Java Virtual Machine 


But some still get through! I can throw ClassCast- 
Exceptions and sometimes I get people trying to 
put the wrong type of thing in an array that was 
declared to hold something else, and— 


OK. Sure. But what about security? Look at all the 
security stuff I do, and you’re like, what, checking 
for semicolons? Oooohbhh big security risk! Thank 
goodness for you! 


Whatever. I have to do that same stuff too, though, 
just to make sure nobody snuck in after you and 
changed the bytecode before running it. 


Oh, you can count on it. Buddy. 


dive in: a quick dip 


The Compiler 


Excuse me, but I wasn’t done. And yes, there are 
some datatype exceptions that can emerge at 
runtime, but some of those have to be allowed to 
support one of Java’s other important features — 
dynamic binding. At runtime, a Java program can 
include new objects that weren’t even known to the 
original programmer, so I have to allow a certain 
amount of flexibility. But my job is to stop any- 
thing that would never—could never—succeed at 
runtime. Usually I can tell when something won’t 
work, for example, if a programmer accidentally 
tried to use a Button object as a Socket connec- 
tion, I would detect that and thus protect them 
from causing harm at runtime. 


Excuse me, but I am the first line of defense, as 
they say. The datatype violations I previously 
described could wreak havoc in a program if they 
were allowed to manifest. Iam also the one who 
prevents access violations, such as code trying to 
invoke a private method, or change a method 
that—for security reasons—must never be 
changed. I stop people from touching code they’re 
not meant to see, including code trying to access 
another class’ critical data. It would take hours, 
perhaps days even, to describe the significance of 
my work. 


Of course, but as I indicated previously, if I didn’t 
prevent what amounts to perhaps 99°% of the po- 
tential problems, you would grind to a halt. And it 
looks like we’re out of time, so we'll have to revisit 
this in a later chat. 
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statements, looping, branching 


What can you say in the main method? 


Once you're inside main (or any method), the fun begins. 
You can say all the normal things that you say in most 
programming languages to make the computer do 
something. 


Your code can tell the JVM to: 


@ do something 


Statements: declarations, assignments, 
method calls, etc. 


int x = 3; 

String name = "Dirk"; 

x= x * 17; 
System.out.print("x is " + x); 


double d = Math.random(); 
// this is a comment 


© do something again and again 


Loops: for and while 


while (x > 12) { 
x=x -1; 

} 

for (int i = 0; i < 10; i =i+41) { 
System.out.print("i is now " + i); 


} 


© do something under this condition 


Branching: if/else tests 
if (x == 10) { 
System.out.print ("x must be 10"); 
} else { 
System.out.print ("x isn't 10"); 
if ((x < 3) && (name.equals("Dirk"))) { 
System.out.printin ("Gently") ; 
} 


System.out.print ("this line runs no matter what"); 
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™ Each statement must end ina 
semicolon. 


x > LT, 


# A single-line comment begins 
with two forward slashes. 


22% 


// this line disturbs me 


% Most white space doesn’t matter. 
3 7 


# Variables are declared with a 
name and a type (you'll learn about 
all the Java types in Chapter 3). 


int weight; 


//type: int, name: weight 


# Classes and methods must be 
defined within a pair of curly braces. 


public void go() { 
// amazing code here 


} 


dive in: a quick dip 


while (moreBalls == true) { 


' keepJuggling(): 


_9 
Looping and looping and... 


Java has a lot of looping constructs: while, do-while, 
and for, being the oldest. You'll get the full loop scoop 
later in the book, but not right now. Let’s start with 
while. 


The syntax (not to mention logic) is so simple you’re 
probably asleep already. As long as some condition is 
true, you do everything inside the loop block. The loop 
block is bounded by a pair of curly braces, so whatever 
you want to repeat needs to be inside that block. 


The key to a loop is the conditional test. In Java, a 
conditional test is an expression that results in a boolean 
value—in other words, something that is either érue 
or false. 


If you say something like, “While iceCreamInT he Tub 

is true, keep scooping,” you have a clear boolean test. 
There either zs ice cream in the tub or there isn’t. But 

if you were to say, “While Bob keep scooping,” you 
don’t have a real test. To make that work, you’d have to 
change it to something like, “While Bob is snoring...” 
or “While Bob 1s not wearing plaid...” 


Simple boolean tests 


You can do a simple boolean test by checking the value 
of a variable, using a comparison operator like: 


< (less than) 
> (greater than) 


== (equality) (yes, that’s wo equals signs) 
Notice the difference between the assignment operator 
(a single equals sign) and the equals operator (vo equals 
signs). Lots of programmers accidentally type = when 
they want ==. (But not you.) 
int x = 4; // assign 4 to x 
while (x > 3) { 
// loop code will run because 
// x is greater than 3 
x = x - 1; // or we'd loop forever 
} 
int z = 27; // 
while (z == 17) { 
// loop code will not run because 


// z is not equal to 17 
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Java basics 
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Dumb Questions 


: Why does everything have 
to be ina class? 


A: Java is an object-oriented 
(OO) language. It’s not like the 
old days when you had steam- 
driven compilers and wrote one 
monolithic source file with a pile 
of procedures. In Chapter 2, A Trip 
to Objectville, you'll learn that a 
class is a blueprint for an object, 
and that nearly everything in Java 
is an object. 


: Dolhave to put a main in 
every class | write? 


A: Nope. A Java program 
might use dozens of classes (even 
hundreds), but you might only 
have one with a main method— 
the one that starts the program 
running. 


Q: In my other language I can 
do a boolean test on an integer. 


In Java, can | say something like: 
int x =1; 


while (x){ } 


A: No. A boolean and an 
integer are not compatible types in 
Java. Since the result of a condi- 
tional test must be a boolean, the 
only variable you can directly test 
(without using a comparison op- 
erator) is a boolean. For example, 
you can say: 


boolean isHot = true; 


while(isHot) { } 
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Example of a while loop 


public class Loopy { 


public static void main(String[] 


args) { 


int x = 1; 


System.out.println("Before the Loop"); 


while 


} 


System.out.println("This is after the loop"); 


} 


% java Loopy 
Before the Loop 


(x < 4) { 
System.out.println("In the loop"); 
System.out.println("Value of x is " + x); 


x=xd¢+1; 


This is the 


— 


output. 


In the loop 


Value of x is 1 


In the loop 


Value of x is 2 


In the loop 


Value of x is 3 


This is after the loop 


BULLET POINTS 


Statements end in a semicolon ; 

Code blocks are defined by a pair of curly braces { } 
Declare an int variable with a name and a type: int x; 
The assignment operator is one equals sign = 

The equals operator uses two equals signs == 


A while loop runs everything within its block (defined by curly 
braces) as long as the conditional test is true. 


If the conditional test is false, the while loop code block won't 
run, and execution will move down to the code immediately 
after the loop block. 


Put a boolean test inside parentheses: 
while (x == 4) { } 


Conditional branching 


In Java, an if test is basically the same as the boolean test in a while 
loop—except instead of saying, “zhile there’s still chocolate,” 
you'll say, “tf there’s still chocolate...” 


class IfTest { 


public static void main (String[] args) { 
int x = 3; 
if (x == 3) { 


System.out.println("x must be 3"); 


} 


System.out.printlin("This runs no matter what"); 


C 
% java IfTest ode output 
x must be 3 


This runs no matter what 


The preceding code executes the line that prints “x must be 3” only if 
the condition (x is equal to 3) is true. Regardless of whether it’s true, 
though, the line that prints “This runs no matter what” will run. So 
depending on the value of x, either one statement or two will print 
out. 


But we can add an else to the condition so that we can say something 
like, “Jf there’s still chocolate, keep coding, else (otherwise) get more 
chocolate, and then continue on...” 


class IfTest2 { 

public static void main(String[] 
2; 

3) { 


System.out.printin("x must be 3"); 


args) { 
int x = 
if (x == 
} else { 

System.out.printlin("x is NOT 3"); 
} 


System.out.printlin("This runs no matter what"); 


New output 
% java IfTest2 


x is NOT 3 — 


This runs no matter what 


dive in: a quick dip 


System.out. print VS. 
System.out.println 


If you've been paying attention (of 
course you have), then you've noticed us 
switching between print and printin. 


Did you spot the difference? 


System.out.printin inserts a newline 
(think of print/n as printnewline), while 
System.out.print keeps printing to 

the same line. If you want each thing 
you print out to be on its own line, use 
println. If you want everything to stick 
together on one line, use print. 


@e sharpen your pencil 
ere yer p 


Given the output: 


% java DooBee 
DooBeeDooBeeDo 


Fill in the missing code: 


public class DooBee { 
public static void main(String[] args) { 
int x = 1; 
while (x < Yeo 
System.out. 
System.out. 
x =xd+i1; 
} 
if (x == ) { 
System.out.print ("Do"); 


—— > Answers on page 25. 
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serious Java app 


Coding a serious business 
application 


Let’s put all your new Java skills to good use with something 
practical. We need a class with a main(), an int and a String 
variable, a while loop, and an if test. A little more polish, and 
you'll be building that business back-end in no time. But before 
you look at the code on this page, think for a moment about 
how you would code that classic children’s favorite, “10 green 


bottles.” 
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public class BottleSong { 


public static void main(String[] args) { 


int bottlesNum = 10; 
String word = "bottles"; 


while (bottlesNum > 0) { 


if (bottlesNum == 1) { 


word = "bottle"; // singular, as in ONE bottle. 


} 
System.out.println(bottlesNum + " green " + word + ", hanging on the wall") ; 
System.out.println(bottlesNum + " green " + word + ", hanging on the wall") ; 


System.out.println("And if one green bottle should accidentally fall,"); 


bottlesNum = bottlesNum - 1; 


if (bottlesNum > 0) { 


System.out.printlin ("There'll be " + bottlesNum + 
" green " + word + ", hanging on the wall"); 


} else { 


System.out.println("There'll be no green bottles, hanging on the wall"); 


} // end else 
} // end while loop 
} // end main method 
} // end class 


There’s still one little flaw in our 
code. It compiles and runs, but the 
output isn’t 100% perfect. See if 
you can spot the flaw and fix it. 
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Dumb Questions 


Q: Didn't this use to be "99 Bottles of Beer"? 


A: Yes, but Trisha wanted us to use the UK version of 
the song. If you'd prefer the 99 bottles version, take that as 
a fun exercise. 


dive in: a quick dip 


Monday morning at Bob’s Java-enabled house 


Bob’s alarm clock rings at 8:30 Monday morning, just like every 
other weekday. But Bob had a wild weekend and reaches for the 
SNOOZE button. And that’s when the action starts, and the 
Java-enabled appliances come to life... 


Java inside 


First, the alarm clock sends a message to the coffee maker a] <— 


“Hey, the geek’s sleeping in again, delay the coffee 12 minutes.” 


The coffee maker sends a message to the Motorola™ toaster, 
“Hold the toast, Bob’s snoozing.” 


Java here too 
— 


. The alarm clock then sends a message to Bob’s 
> | Android, “Call Bob’s 9 o’clock and tell him we’re 


Se srunning a little late.” 


Finally, the alarm clock sends a message to Sam’s 

(Sam is the dog) wireless collar, with the too- 

A Loy familiar signal that means, “Get the paper, but \ 
| ’ Ik.” ) \ C\s 

Gy don’t expect a wa Carn : se 

nas Y8 


toaste A few minutes later, the alarm goes off again. And again Bob hits SNOOZE and 
the appliances start chattering. Finally, the alarm rings a third 
time. But just as Bob reaches for the snooze button, the clock 1. 
sends the “jump and bark” signal to Sam’s collar. Shocked to he 
full consciousness, Bob rises, grateful that his Java skills, and 
spontaneous internet shopping purchases, have enhanced the daily 
routines of his life. 


butter here 


c/ 


Just another wonderful morning in The Java-Enabled House. 


His toast is toasted. 


His coffee steams. 


His paper awaits. 


Could this story be true? Mostly, yes! There are versions of Java running in devices 
including cell phones (especially cell phones), ATMs, credit cards, home security 
systems, parking meters, game consoles and more—but you might not find a Java 
dog collar...yet. 


Java has multiple ways to use just a tiny part of the Java platform to run on smaller 
devices (depending upon the version of Java you're using). It’s very popular for loT 
(Internet of Things) development. And, of course, lots of Android development is 
done with Java and JVM languages. 
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s write a program 


OK, so the bottle song wasn’t really a 
serious business application. Still need 


something practical to 


show the boss? 


Check out the Phrase-O-Matic code. 
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Try my new 
phrase-o-matic and 
you'll be a slick talker 

just like the boss or those 
hotshots in marketing. 


public class PhraseOMatic { 
public static void main (String[] args) { 


// make three sets of words to choose from. Add your own! 


String[] wordListOne = {"agnostic", "opinionated", 
"yoice activated", "haptically driven", "extensible", 
"reactive", "agent based", "functional", "AI enabled", 


"strongly typed"}; 


String[] wordListTwo = {"loosely coupled", "six sigma", 


"asynchronous", "event driven", "pub-sub", "IoT", "cloud 
native", "service oriented", "containerized", "serverless", 
"microservices", "distributed ledger"}; 

String[] wordListThree = {"framework", "library", 
"DSL", "REST API", "repository", "pipeline", "service 
mesh", "architecture", "perspective", "design", 


"orientation" } ; 


// find out how many words are in each list 


2) int oneLength = wordListOne. length; 


int twoLength = wordListTwo.length; 
int threeLength = wordListThree. length; 


// generate three random numbers 


let 3) java.util.Random randomGenerator = new java.util.Random() ; 


int randl = randomGenerator.nextInt (oneLength) ; 
int rand2 = randomGenerator.nextInt (twoLength) ; 
int rand3 = randomGenerator.nextInt (threeLength) ; 


// now build a phrase 
String phrase = wordListOne[rand1l] +" " + 
wordListTwo[rand2] + " " + wordListThree[rand3] ; 


@ // print out the phrase 


System.out.println ("What we need is a " + phrase) ; 
} 
} 


Phrase-0-Matic 


How it works 


In a nutshell, the program makes three lists of words, then randomly picks one word from each 
of the three lists, and prints out the result. Don’t worry if you don’t understand exactly what’s 
happening in each line. For goodness sake, you’ve got the whole book ahead of you, so relax. 
This is just a quick look from a 30,000-foot outside-the-box targeted leveraged paradigm. 


4. The first step is to create three String arrays—the containers that will hold all the words. 
Declaring and creating an array is easy; here’s a small one: 


String[] pets = {"Fido", "Zeus", "Bin"}; 


Each word is in quotes (as all good Strings must be) and separated by commas. 


2 For each of the three lists (arrays), the goal is to pick a random word, so we have to know 
how many words are in each list. If there are 14 words in a list, then we need a random num- 
ber between 0 and 13 (Java arrays are zero-based, so the first word is at position 0, the second 
word position 1, and the last word is position 13 in a 14-element array). Quite handily, a Java 

array is more than happy to tell you its length. You just have to ask. In the pets array, we'd say: 


int x = pets.length; 


and x would now hold the value 3. 


3 « We need three random numbers. Java ships out of the box with several ways to generate 
random numbers, including java.util.Random (we will see later why this class name is prefixed 
with java.util). The nextInt() method returns a random number between 0 and some-num- 
ber-we-give-it, not including the number that we give it. So we'll give it the number of elements 
(the array length) in the list we’re using. Then we assign each result to a new variable. We could 
just as easily have asked for a random number between 0 and 5, not including 5: 


int x = randomGenerator.nextInt (5) ; 


4. Now we get to build the phrase, by picking a word from each of the three lists and 
smooshing them together (also inserting spaces between words). We use the “+” operator, 
which concatenates (we prefer the more technical smooshes) the String objects together. To get an 
element from an array, you give the array the index number (position) of the thing you want by 
using: 

String s = pets[0]; // s is now the String "Fido" 


s=s+" " + "is a dog"; // s is now "Fido is a dog" 


5 « Finally, we print the phrase to the command line and...voila! We’re in marketing. 


dive in: a quick dip 


what we need 
here is a... 


extensible microser- 
vices pipeline 


opinionated loosely 
coupled REST API 


agent-based 
microservices library 


Al-enabled service 
oriented orientation 


agnostic pub-sub 
DSL 


functional loT 
perspective 
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Output: 
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Code Magnets 


A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 


% java Shufflel 


a-b c-d 


System.out.print("b ca"); 


int x = 3; 


———+ Answers on page 25. 


BE the Compiler 


Each of the Java files on this page 
. Pepresents a complete source file. 
Ui. Your job is to play compiler and 
V%\, determine whether each of these files 
\ will compile. If they won't 
compile, how would you 
fix them? 


> Answers on page 25. 


A 


class Exercisela { 
public static void main(String[] args) { 
int x =1; 
while (x < 10) { 
if (x > 3) { 
System.out.println("big x"); 
} 
} 
} 
} 


dive in: a quick dip 


B 


public static void main(String [] args) { 
int x = 5; 
while (x>1) { 
x=x-1; 
if (x < 3) { 
System.out.println("small x"); 
} 
} 
} 


Cc 


class Exerciselc { 
int x = 5; 
while (x > 1) { 
x=x-1; 
if (x < 3) { 
System.out.println("small x"); 
} 
} 
} 
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puzzle: crossword 


JavaCrass 


Let’s give your right brain something to do. 


It’s your standard crossword, but almost all 
of the solution words are from Chapter 1. 
Just to keep you awake, we also threw in 

a few (non-Java) words from the high-tech 
world. 


Across 

4. Command line invoker 

6. Back again? 

8. Can't go both ways 

9. Acronym for your laptop's power 
12. Number variable type 

13. Acronym for a chip 

14. Say something 

18. Quite a crew of characters 

19. Announce a new class or method 


21. What's a prompt good for? 


——————> Answers on page 26. 
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Down 


1. Not aninteger(or___ your boat) 
2. Come back empty-handed 

3. Open house 

5. ‘Things’ holders 

7. Until attitudes improve 

10. Source code consumer 

11. Can't pin it down 

13. Department for programmers and operations 
15. Shocking modifier 

16. Just gotta have one 

17. How to get things done 


20. Bytecode consumer 


A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left) with the output that you’d see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 


Messages connecting the candidate blocks of code with their matching 


command-line output. 


dive in: a quick dip 


class Test { 
public static void main(String [] args) { 
int x = 0; 
int y = 0; C3 
while (x <5) { ndidate ¢ 
Joes here 
System.out.print(x + "" + y +" "); 
x = x4 ii; 
} 
} 
} 
Candidates: Possible output: 
Matth eath Vane ease 22 46 
candidate wt 
one of the ks ie At ii 34 59 
possible out 
Y Cas veoh eZ 
ip es ye 02 4 26 38 
Yor yor, 
} 02 14 36 48 
Sa Phy (OmUine imooma 
Var Yeas 
ie ee 6 Va iil Ail Be @A Be 
oe SS og cp ile 
WE yee) 00 11 23 36 410 
Be Soe lp 
} @2 1A ah 36 AT 
} 
MES Ia ————— Answers on page 26. 
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puzzle: Pool Puzzle 


66] Puzzle 
Your job is to take code snippets from the 
pool and place them into the blank 
lines in the code. You may not use the 
same snippet more than once, and 
you won't need to use all the snip- 
pets. Your goal is to make a class that 
will compile and run and produce the 
output listed. Don’t be fooled—this one’s 
harder than it looks. 


———> Answers on page 26. 


Output 


| File Edit Window Help Cheat 
java PoolPuzzleOne 


a noise 
annoys 


an oyster 


Note: Each snippet 
from the pool can be 
used only once! 


x>3 
x<4 


System.out.print(” "); 
System.out.print("a"); 
System.out.print("n"); 
System.out.print("an"); 
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class PoolPuzzleOne { 
public static void main(String [] args) 
int x = 0; 


while ( ) 


if (x<1) { 


} 


if ( ){ 


} 
if (x==1) { 


System.out.println(); 


System.out.print("noys "); 
System.out.print("oise "); 
System.out.print(" oyster "); 
System.out.print("annoys"); 
System.out.print("noise"); 


Exercise Solutions 


Sharpen your pencil (from page 14) 


BE the Compiler 


(from page 21) 


public class DooBee { 
public static void main(String[] args) { 
int x 1; 
while (x < 3) { 
System.out.print ("Doo") ; 
System.out.print ("Bee") ; 
x x +1; 


} 
if (x == 3) { 
System.out.print("Do") ; 
} 
} 
} 


Code Magnets (from page 20) 
class Shufflel { 
public static void main(String[] args) { 


eb sh ome. < 33 
while (x > 0) { 


if (x > 2) { 
System.out.print("a"); 


x x - 1; 


System.out.print("-"); 
if (x == 2) { 
System.out.print("b c"); 


if (x == 1) { 
System.out.print("d"); 


x x - 1; 


} 
} % java Shufflel 


a-b c-d 


dive in: a quick dip 
class Exercisela { 
public static void main(String [] args) { 
int x = 1; 
while ( x < 10 ) 
x=x+l <_ 
if ( x> 3) { 


‘hdd this line to prevent 


1b running forever--- 


> 


System.out.println("big x"); 


} This will compile and run (no output), but 
} without a line added to the program, it 
would run forever in an infinite while loop! 


class Exerciselb { <~ Needs a class declaration 


public static void main(String [] args) { 
int x = 5; 
while (x>1) { 
x= 


if (x <3) { 


x - 1; 
System.out.println("small x"); 


} This file won't compile without a 
} class declaration, and don't forget 
} the matching curly brace! 


class Exerciselc { 1 Needs : “main” 
public static void main(String [] args) { 
int x = 5; 
while (x>1) { 
x=x-1; 
LE iS Bye f 


System.out.println("small x"); 


} The while loop code must be inside a 
} method. It can't just be hanging out 
} inside the class. 
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puzzle answers 


Poa] Puzzle (from page 24) 


class PoolPuzzleOne { 


26 


public static void main(String [] args) { 


} 


int x = 0; 
while ( x<4) { 


System.out.print("a"); 
if (x<1){ 
System.out.print(""); 


} 


System.out.print("n"); 


if ( x>1) { 
System.out.print(" oyster"); 
X=X+2; 

} 

if (x=1) { 
System.out.print("noys"); 

} 

if ( x<1) { 
System.out.print("oise"); 


} 
System.out.printl1n(); 


xX=X+1; 


} 


| File Edit_Window Help Cheat | 
%$java PoolPuzzleOne 


a noise 
annoys 


an oyster 
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JavaCrass (from page 22) 
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Mixed 
Messages 


F| [Vv 
“gla lv fA *‘LiololP 
R ‘wl |o| |r 
PBIRIAINIC|H| |/A;| [bol/c| |V 
A T IN| T fe) A 
y L M| JR] [I 
siyls|tlelmMioljult fp i/R|z iN it 
T A t a 
A I L| |B 
“s[T/R/IINIG| [DIElc |L JAR 
I R| |e 
ic | 


class Test { 


public static void main(String 
int x = 0; 
int y = 
while (x< 5) { 


{] args) 


{ 


System.out.print(x + ""_+ y +" ") 
x = x + 1; 
} 
} 
} 
Candidates: Possible output: 
WY Sts = 379 22 46 
ala ees 11 34 59 
y=yt2 
He ses 4 02 14 26 38 
vweweo Ll 
} 02 14 36 48 
a 00 11 21 32 42 
Vasey sec, 
[a ili Pa sy AI) Bz) 
4 Sl zeae lp 
ae ( 7 ~ 3B) 4 00 11 23 36 410 
x=x-i1 
} 02 14 25 36 47 
} 
yes ap 2 
(from page 23) 


2 classes and objects 


A Trip to Objectville 


We're going to 
Objectville! We're 
leaving this dusty ol’ 
procedural town for good. 
T'll send you a postcard. 


| was told there would be objects. In Chapter 1, we put all of our code in 

the main() method. That's not exactly object-oriented. In fact, that’s not object-oriented at 

all. Well, we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn’t 
actually develop any of our own object types. So now we've got to leave that procedural world 
behind, get the heck out of main(), and start making some objects of our own. We'll look at 
what makes object-oriented (OO) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can give you a better life (at least the 
programming part of your life. Not much we can do about your fashion sense). Warning: once 


you get to Objectville, you might never go back. Send us a postcard. 


this is a new chapter 27 


once upon a time in Objectville 


Chair Wars 


(or How Objects Can Change Your Life) 


i, the spec 

nce upon a time in a software shop, two programmers 

were given the same spec and told to “build it.” The J 

Really Annoying Project Manager forced the two 

coders to compete, by promising that 

whoever delivers first gets a cool Aeron™ 

chair and adjustable height standing desk like 
all the Silicon Valley techies have. Laura, the 


procedural programmer, and Brad, the OO 
developer, both knew this would be a piece of 
cake. 


Laura, sitting at her (non-adjustable) desk, 
thought to herself, “What are the things this 
program has to do? What procedures do we 
need?” And she answered herself, “rotate 

and playSound.” So off she went to build the 
procedures. After all, what 7s a program if not a 
pile of procedures? 


Brad, meanwhile, kicked back at the coffee shop 
and thought to himself, “What are the things in 
this program...who are the key players?” He first 
thought of The Shapes. Of course, there were 
other things he thought of like the User, the Sound, and the 
Clicking Event. But he already had a library of code for those 
pieces, so he focused on building Shapes. Read on to see how 
Brad and Laura built their programs, and for the answer to your 
burning question, “So, who got the Aeron and the desk?” 


3. 


as the chair 


At Laura’s desk At Brad’s laptop at the cafe 


As she had done a gazillion times before, Laura 
set about writing her Important Procedures. 


; : Square 
She wrote rotate and playSound in no time. : 


Brad wrote a class for each of the three shapes. 


rotate (shapeNum) { 
// make the shape rotate 360° 
} 
playSound(shapeNum) { 
// use shapeNum to lookup which 
// AIF sound to play, and play it 
} 


28 chapter 2 


rotate) 
II code to rotate a s 

} rotate() { Triangle 
II code to rotate a q 
playSound() { } 
/I code to play the A 
y for a square 


rotate() { 

/I code to rotate a triangle 

playSound() { } 
|! code to play the 
/I for a circle 


playSound() { 
/I code to play the AIF file 
( for a triangle 


Laura thought she'd nailed it. She could almost feel the 


rolled steel of the Aeron beneath her... 


But wait! There’s been a spec change. 


classes and objects 


“OK, technically you were first, Laura,” said the Manager, “but we have to add just one tiny 
thing to the program. It'll be no problem for crack programmers like you two.” 


“Tf I had a dime for every time [ve heard that one,” thought Laura, knowing that spec-change-no- 
problem was a fantasy. “And yet Brad looks strangely serene. What’s up with that?” Stull, Laura held 
tight to her core belief that the OO way, while cute, was just slow. And that if you wanted to 
change her mind, you'd have to pry it from her cold, dead, carpal-tunnelled hands. 


others, a 
file. 


Back at Laura’s desk 


The rotate procedure would still work; the code used a 
lookup table to match a shapeNum to an actual shape 
graphic. But playSound would have to change. 


playSound(shapeNum) { 
// if the shape is not an amoeba, 
// use shapeNum to lookup which 
// AIF sound to play, and play it 
// else 
// play amoeba .mp3 sound 
I 
It turned out not to be such a big deal, but it still made 
her queasy to touch previously tested code. Of all 
people, she should know that no matter what the project 


manager says, the spec always changes. 


a what got added to the spec 


At Brad’s laptop at the beach 


Brad smiled, sipped his fruit frappe, and wrote one new 
class. Sometimes the thing he loved most about OO was 
that he didn’t have to touch code he’d already tested 
and delivered. “Flexibility, extensibility, ...” he mused, 
reflecting on the benefits of OO. 


Amoeba 


rotate() { 
// code to rotate an amoeba 


} 


playSound() { 
// code to play the new 
// .mp3 file for an amoeba 


} 
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once upon a time in Objectville 


Laura delivered just moments ahead of Brad 


(Hah! So much for that foofy OO nonsense.) But the smirk on Laura’s face melted when the Really 
Annoying Project Manager said (with that tone of disappointment), “Oh, no, éhat’s not how the amoeba 
is supposed to rotate...” 


Turns out, both programmers had written their rotate code like this: 
1. determine the rectangle that surrounds the shape. / \ 
2. calculate the center of that rectangle, and rotate the shape around that point. / \ 

But the amoeba shape was supposed to rotate around a point on one end, like a clock hand. 

“Tm toast,” thought Laura, visualizing charred Wonderbread™. “Although, hmmmm. I could just add 

another if/else to the rotate procedure and then just hard-code the rotation point code for the amoeba. 

That probably won’t break anything.” But the little voice at the back of her head said, “Big Mistake. Do 

you honestly think the spec won't change again?” 


What the spec conveniently 
forgot to mention 


Back at Laura’s desk At Brad’s laptop on his lawn 
She figured she better add rotation point arguments chair at the Telluride Bluegrass Festival 


to the rotate procedure. A lot of code was affected. 
Testing, recompiling, the whole nine yards all over again. 
Things that used to work, didn’t. 


Without missing a beat, Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested, 


rotate (shapeNum, xPt, yPt) { working, compiled Amoeba 
ee eee ee code for the other parts of _ | int xPoint 
// calculate the center point ; ‘ : 
// based on a rectangle, the program. To give the int yPoint 
// then rotate Amoeba a rotation point, he] rotate() { 
// else added an attribute that all | // code to rotate an amoeba 
(7 use the eee ne VEE ee Amoebas would have. He /| using amoeba’s x and y 
// the rotation point offset : : } 
// and then rotate modified, tested, and deliv- 
} ered (via free festival WiFi) | playSound() { 


the revised program during | // code to play the new 
/I .mp3 file for an amoeba 


} 


a single Bela Fleck set. 
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classes and objects 


So, Brad the 00 guy got the chair and desk, right? 


Not so fast. Laura found a flaw in Brad’s approach. And, 
since she was sure that if she got the chair and desk, she’d 
also be next in line for a promotion, she had to turn this thing 
around. 


LAURA: You've got duplicated code! The rotate procedure is 
in all four Shape things. 


BRAD: It’s a method, not a procedure. And they’re classes, 
not things. 


LAURA: Whatever. It’s a stupid design. You have to maintain 
Jour different rotate “methods.” How can that ever be good? 


BRAD: Oh, I guess you didn’t see the final design. Let me 
show you how OO inheritance works, Laura. 


What Laura really wanted > 


(figured the chair was a step closer 
to that promotion and the big bucks) 


| looked at what all four 
rotate() classes have in common. 


playSound() 4 


rotate() rotate() rotate() 
playSound() playSound() playSound() 


They’re Shapes, and they all rotate and 


playSound. Sol abstracted out the oer 3) 
common features and put them into a playSound() 
new class called Shape. — Then | linked the other 
superclass four shape classes to 
P eae the new Shape class, 
in a relationship called 


inheritance. 
You can read this as, “Square inherits from Shape,” 


“Circle inherits from Shape,” and so on. | removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 


subelasses 


The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 
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once upon a time in Objectville 


What about the Amoeba rotate()? 


LAURA: Wasn’t that the whole problem here—that the amoeba shape had a 


completely different rotate and playSound procedure? 


BRAD: Method. 


LAURA: Whatever. How can Amoeba do something different if it 


“inherits” its functionality from the Shape class? 


BRAD: That’s the last step. The Amoeba class overrides the methods 


of the Shape class. Then at runtime, the JVM knows exactly which rotate() 
method to run when someone tells the Amoeba to rotate. 


superclass 
(more abstract) 


rotate() 
playSound() 


subclasses 
(more specific) 


LAURA: How do you “tell” an Amoeba to do 
something? Don’t you have to call the procedure, 
sorry —method, and then tell it which thing to 
rotate? 


BRAD: That’s the really cool thing about OO. 
When it’s time for, say, the triangle to rotate, the 
program code invokes (calls) the rotate() method 
on the triangle object. The rest of the program really 
doesn’t know or care how the triangle does it. 

And when you need to add something new to the 
program, you just write a new class for the new 
object type, so the new objects will have their 
own behavior. 
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| made the Amoeba class override 
the rotate() and playSound() 
methods of the superclass Shape. 


Overriding just means that a 
subclass redefines one of its 
inherited methods when it needs 
to change or extend the behavior 
of that method. 


rotate() { 

// amoeba-specific 

// rotate code oi 
; Overriding methods 

playSound() { a 

// amoeba-specific 

/} sound code } 


[ 
can take care of 
myself. I know how 
an Amoeba is supposed to 
rotate and play a 
sound. 


I know how a Shape is 
supposed to behave. Your 
job is to tell me what to 
do, and my job is to make it happen. 
Don't you worry your little program- 
mer head about how I do it. 


O 


classes and objects 


The suspense is killing me. 
Who got the chair and desk? 


Amy from the second floor. 


(Unbeknownst to all, the Project 


Manager had given the spec to three 


programmers. Amy completed 


the project faster since she got on 


with OO programming without 
arguing with her co-workers). 


What do you like about 00? 


“It helps me design in a more natural way. Things 
have a way of evolving." 
-Joy, 27, software architect 


“Not messing around with code I've already 
tested, just to add a new feature.” 
-Brad, 32, programmer 


“I like that the data and the methods that oper- 
ate on that data are together in one class." 
-Jess, 22, foosball champion 


“Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later." 

-Chris, 39, project manager 


“I can't believe Chris, who hasn't written a line of 
code in 5 years, just said that." 


-Daryl, 44, works for Chris 


“Besides the chair?” 
-Amy, 34, programmer 


Sk, RAL 
TTPOweER 
Time to pump some neurons. 


You just read a story about a procedural 
programmer going head-to-head with an OO 
programmer. You got a quick overview of some 
key OO concepts including classes, methods, 
and attributes. We'll spend the rest of the 
chapter looking at classes and objects (we'll 
return to inheritance and overriding in later 
chapters). 


Based on what you've seen so far (and what you 
may know from a previous OO language you've 
worked with), take a moment to think about 
these questions: 


What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 

If you could design a checklist to use when 
you're designing a class, what would be on the 
checklist? 


metacognitive tip 


If you’re stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 


a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That's how 

our dog learned polymorphism. 
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thinking about objects 


When you design a class, think about the objects that 
will be created from that class type. Think about: 


H things the object knows 
@ things the object does 


cartContents knows Be 
color 
setColor! 

ee does eer 


removeFromCart() 


checkOut() push() 


release() 


Things an object knows about itself are called 


alarmTime 


knows alcinnblécle knows 


setAlarmTime() 

does getAlarmTime() does 
isAlarmSet() 
snooze() 


@ instance variables instance 
variables knows 
(state) 
; : tTitl 
Things an object can do are called methods | cctaricty Hoes 
(behavior) play() 
H methods 


Things an object Knows about itself are called instance 
variables. ‘They represent an object’s state (the data) and can 
have unique values for each object of that type. 


Think of instance as another way of saying object. 


Things an object can do are called methods. When you 
design a class, you think about the data an object will need to 
know about itself, and you also design the methods that operate 
on that data. It’s common for an object to have methods that 
read or write the values of the instance variables. For example, 
Alarm objects have an instance variable to hold the alarmTime, 
and two methods for getting and setting the alarmTime. 


So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 
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Ge harpen your pencil 


Fill in what a television object 
might need to know and do. 


Television 


instance 
variables 


methods 


—-+ Your’ to solve. 


classes and objects 


What’s the difference between 
a class and an object? 


A class is not an object 
(but it’s used to construct them) 


one class 


A class is a blueprint for an object. It tells 
the virtual machine how to make an object of that 
particular type. Each object made from that class 
can have its own values for the instance 
variables of that class. For example, 
many objects Yo" might use the Button class to make 
dozens of different buttons, and each 
button might have its own color, size, shape, 
label, and so on. Each one of these different 
buttons would be a button olyect. 


An object is like one entry in your contacts list. 


One analogy for classes and objects is your phone’s contact list. 
Each contact has the same blank fields (the instance variables). 
When you create a new contact, you are creating an instance 

(object), and the entries you make for that contact represent its 


' tate. 
Name Polly Morfism oe 


The methods of the class are the things you do to a particular 
Phone _SOS-OS#S ___ contact; getName( ), changeName( ), setName() could all be 
eMail PU@wickedlysmart methods for class Contact. 


So, each contact can do the same things (getName( ), 
changeName( ), etc.), but each individual contact knows things 
unique to that particular contact. 
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making objects 


Making your first object 


So what does it take to create and use an object? You need two classes. One class 
for the type of object you want to use (Dog, AlarmClock, ‘Television, etc.) and an- 
other class to éest your new class. The fester class is where you put the main method, 
and in that main() method you create and access objects of your new class type. 
The tester class has only one job: to ¢ry out the methods and variables of your new 
object. 


From this point forward in the book, you'll see two classes in many of our 
examples. One will be the real class—the class whose objects we really want to use, 
and the other class will be the fester class, which we call <WhateverYourClassNamels> 
TestDrive. For example, if we make a Bungee class, we'll need a 
BungeeTestDrive class as well. Only the <SomeClassName>TestDrive 

class will have a main() method, and its sole purpose is to create objects of your 
new class (the not-the-tester class), and then use the dot operator (.) to access the 
methods and variables of the new objects. This will all be made stunningly clear by 
the following examples. No, really. 


class Dog { 
int size; 
String breed; 
String name; 


A method 

wid tak ¢ 
System.out.println("Ruff! Ruff!") ; 

} 


The Dot Operator (.) 


The dot operator (.) gives 
you access to an object's 
state and behavior (instance 
variables and methods). 


// make a new object 


Dog d = new Dog(); 


// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 


d.bark(); 


// set its size using the 
// dot operator 


d.size = 40; 


} (2) Write a tester (TestDrive) class 
eknod class DogTestDrive { 
Just g main mw ‘i Lode public static void main(String[] args) { 
( eve gon? rd key? // Dog test code goes here 
“i “ww {ne } 


} 


In your tester, make an object and access 
the object's variables and methods 


class DogTestDrive { 
public static void main(String[] args) { 
Dog d = new Dog(); <— Mak 
d.size = 40; Lise 4 ao Dog object 
De —- a.bark(); K_U¢ the dot operator (.) 
opera” to set the size of the Do 
} 


3 
and to call its barkQ) method 
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If you already have some OO savvy, 


you'll know we're not using encapsulation. 


We'll get there in Chapter 4, How 
Objects Behave. 


classes and objects 


Making and testing Movie objects 


class Movie { 
String title; 
String genre; 
int rating; 


void playIt() { 

~~ i System.out.println("Playing the movie") ; 
Ny! h ‘a 

City, <b dh te } 

SPS G 2, 


KILLER OBJEC hah : ; ; 
OUTER SPACE P| public class MovieTestDrive { 


——————— 4 public static void main(String[] args) { 
= Movie one = new Movie() ; 

one.title = "Gone with the Stock"; 

one.genre = "Tragic"; 

one.rating = -2; 

Movie two = new Movie() ; 

two.title = "Lost in Cubicle Space"; 

two.genre = "Comedy"; 

two.rating = 5; 

two.playIt() ; 

Movie three = new Movie() ; 

three.title = "Byte Club"; 

three.genre = "Tragic but ultimately uplifting"; 

three.rating = 127; 


} 
} 
G harpen ourpencil 
title 
object 1 genre 
rating 
title 
The MovieTestDrive class creates objects (instances) of object2 | genre 


the Movie class and uses the dot operator (.) to set the 
instance variables to a specific value. The MovieTest- 
Drive class also invokes (calls) a method on one of the 
objects. Fill in the chart to the right with the values the title 
three objects have at the end of main(). 


rating 


object 3 genre 


—» Yours to solve. rating 
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get the heck out of main 


Quick! Get out of main! 


As long as you’re in main(), you’re not really in Objectville. It’s fine for a test program 
to run within the main method, but in a true OO application, you need objects talk- 
ing to other objects, as opposed to a static main() method creating and testing objects. 


The two uses of main: 
@ to test your real class 
# to launch/start your Java application 


A real Java application is nothing but objects talking to other objects. In this case, 
talking means objects calling methods on one another. On the previous page, and in 
Chapter 4, How Objects Behave, we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
Chapter 6, Using the Java Library, we look at using a class with a main() method to start 
the ball rolling on a zeal Java application (by making objects and then turning those 
objects loose to interact with other objects, etc.) 


As a “sneak preview,” though, of how a real Java application might behave, here’s a 
little example. Because we’re still at the earliest stages of learning Java, we’re work- 
ing with a small toolkit, so you'll find this program a little clunky and inefficient. You 
might want to think about what you could do to improve it, and in later chapters 
that’s exactly what we'll do. Don’t worry if some of the code is confusing; the key 
point of this example is that objects talk to objects. 


The Guessing Game 


Summary: 


The Guessing Game involves a game object and three player objects. The game gen- 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn’t say it was a really exciting game.) 


Classes: 


GuessGame.class Player.class GameLauncher.class 


The Logic: 
1. The GameLauncher class is where the application starts; it has the main() method. 


2. In the main() method, a GuessGame object is created, and its startGame() method 
is called. 


3. The GuessGame object's startGame() method is where the entire game plays out. It 
creates three players and then “thinks” of a random number (the target for the play- 
ers to guess). It then asks each player to guess, checks the result, and either prints 
out information about the winning player(s) or asks them to guess again. 
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main(String[] args 


GuessGame 


number 


classes and objects 


public class GuessGame { GuessGame has three inst 
Player pl; variables for the rh PI nce 
Player p2; E objects. ee layer 
Player p3; 
public void startGame() { Create th 
ree Player obi 
pl = new Player(); ass} yi objects and 
p2 = new Player(); i wok them to the three Player 
p3 = new Player(); stance variables. 
int guesspl = 0; Detlare three vari 
int guessp2 = 0; iables to hold the 


three guess 
int guessp3 = 0; 3 es the Players make. 


boolean plisRight = false; D . 
<< eclare three variables to hold 
ey _ f old a tr 
boolean pols gne false; false based a th ; + ue or 
boolean p3isRight = false; e player's answer. 


ake a | ? 
int targetNumber = (int) (Math.random() * 10); <— i me ee number that 
System.out.println("I'm thinking of a number between 0 and 9..."); € Players have to Suess. 


while (true) { 
System.out.printlin("Number to guess is " + targetNumber) ; 


pl.guess(); ) 
a ween 0) ~— Call each player's guess() method. 


p3.guess(); 


guesspl = pl.number; 
System.out.printlin("Player one guessed " + guesspl1); 


guessp2 = p2.number; Get each player’s Quess (the result of their 
System.out.println("Player two guessed " + guessp2) ; guess() method running) b accessing the 


guessp3 = p3.number; number variable of eath Player. 
System.out.printin("Player three guessed " + guessp3); 


if (guesspl == targetNumber) { 

plisRight = true; 
} Cheek each player's Suess to see if it 
if (guessp2 == targetNumber) { matches the target number: If a pla avis 
pele = weer right, then set that player's carable be 
Se tee ea eee need rue (remember, we set it false by default). 


p3isRight = true; 
} 


if (plisRight || p2isRight || p3isRight) { If Payer one OR player two 0 


R player three is vi 
System.out.println("We have a winner!"); (the | operator means OR). = ght 
System.out.printlin("Player one got it right? " + plisRight); 

System.out.printlin("Player two got it right? " + p2isRight); 
System.out.println ("Player three got it right? " + p3isRight); 
System.out.printin("Game is over."); 


break; // game over, so break out of the loop 


} else { 
// we must keep going because nobody got it right! Otherwise Stay 
System.out.println("Players will have to try again."); players f,. Y n the loop and 
} // end if/else another, Sues ask the 
} // end loop 


} // end method 
} // end class 
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Guessing Game 


Running the Guessing Game 


40 


Java takes out the 
Garbage 


Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. All 
objects—no matter when, where, or how 
they’re created—live on the heap. But it’s 
not just any old memory heap; the Java 
heap is actually called the Garbage- 
Collectible Heap. When you create an 
object, Java allocates memory space on 
the heap according to how much that 
particular object needs. An object with, 
say, 15 instance variables, will probably 
need more space than an object with 
only two instance variables. But what 
happens when you need to reclaim 
that space? How do you get an object 
out of the heap when you're done with 
it? Java manages that memory for you! 
When the JVM can “see” that an object 
can never be used again, that object 
becomes eligible for garbage collection. 
And if you're running low on memory, 
the Garbage Collector will run, throw out 
the unreachable objects, and free up the 
space so that the space can be reused. 
In later chapters you'll learn more about 
how this works. 
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Output (it will be different each time you run it) 


%Sjava GameLauncher 


I’m thinking of a number between 0 and 9... 
Number to guess is 7 

I’m guessing 1 

I’m guessing 9 

I’m guessing 9 

Player one guessed 1 

Player two guessed 9 

Player three guessed 9 

Players will have to try again. 
Number to guess is 7 

I’m guessing 3 

I’m guessing 0 

I’m guessing 9 

Player one guessed 3 

Player two guessed 0 

Player three guessed 9 

Players will have to try again. 
Number to guess is 7 

I’m guessing 7 

I’m guessing 5 

I’m guessing 0 

Player one guessed 7 

Player two guessed 5 

Player three guessed 0 

We have a winner! 

Player one got it right? true 
Player two got it right? false 
Player three got it right? false 


Game is over. 
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Dumb Questions 


Q: What if | need global 
variables and methods? How 
do | do that if everything has to 
go inaclass? 


A: There isn’t a concept of 
“global” variables and methods 
in a Java OO program. In 
practical use, however, there 
are times when you want a 
method (or a constant) to be 
available to any code running in 
any part of your program. Think 
of the random() method in 
the Phrase-O-Matic app; it’s a 
method that should be callable 
from anywhere. Or what about 
a constant like pi? You'll learn 

in Chapter 10 that marking 
amethod as public and 
static makes it behave much 
like a “global.” Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static, and final, 
you have essentially made a 
globally available constant. 


Q: Then how is this object- 
oriented if you can still make 
global functions and global 
data? 


A: First of all, everything 

in Java goes ina class. So the 
constant for pi and the method 
for random (), although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java. They represent a very 
special case, where you don't 
have multiple instances/objects. 


Q: What is a Java program? 
What do you actually deliver? 


A: A Java program is a pile 
of classes (or at least one class). 
In a Java application, one of 

the classes must have a main 
method, used to start up the 
program. So as a programmer, 
you write one or more classes. 
And those classes are what you 
deliver. If the end user doesn’t 
have a JVM, then you'll also 
need to include that with your 
application's classes so that 
they can run your program. 
There are a number of 
programs that let you bundle 
your classes with a JVM and 
create a folder or file you can 
share however you want (e.g., via 
the internet). Then the end user 
can install the correct version 
of the JVM (assuming they don’t 
already have it on their machine). 


Q: What if | have a hundred 
classes? Or a thousand? Isn't 
that a big pain to deliver 

all those individual files? 

Can I bundle them into one 
Application Thing? 


A: Yes, it would be a big 

pain to deliver a huge bunch of 
individual files to your end users, 
but you won't have to. You can 
put all of your application files 
into a Java ARchive—a .jar file— 
that’s based on the pkzip format. 
In the jar file, you can include 

a simple text file formatted as 
something called a manifest, that 
defines which class in that jar 
holds the main () method that 
should run. 


-—— BULLET POINTS 


classes and objects 


Java is 
Pass 
by Value 


Way | 
est | 
notify( ) bn 


A class is likea recipe 


Objects are |j 
I 
Cookie ite 


» Chip. Cookies 
«gat 2048 chocolate th ips 
i od 


Object-oriented programming lets you extend 
a program without having to touch previously 
tested, working code. 

All Java code is defined in a class. 

Aclass describes how to make an object of 
that class type. A class is like a blueprint. 
An object can take care of itself; you don’t 
have to know or care how the object does it. 
An object knows things and does things. 
Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 
When you create a class, you may also want 
to create a separate test class that you'll use 
to create objects of your new class type. 

A class can inherit instance variables and 
methods from a more abstract superclass. 
At runtime, a Java program is nothing more 
than objects “talking” to other objects. 
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exercise: Be the Compiler 


A 


class StreamingSong { 


String title; 
String artist; 
int duration; 


void play() { 
System.out.println ("Playing song") ; 
} 


void printDetails() { 
System.out.println("This is " + title + 
"by " + artist) ; 
} 
} 


class StreamingSongTestDrive { 
public static void main(String[] args) { 


song.artist = "The Beatles"; 
song.title = "Come Together"; 


song.play () ; 
song.printDetails() ; 


—————> Answers on page 46. 


42 chapter 2 


« Each of the Java files on this page 
g. represents a complete source file. 
. Your job is to play compiler and 
| determine whether each of 


these files will compile. 
If they won’t compile, 


how would you fix them, 
and sf they do compile, what 
would be their output? 


class Episode { 


int seriesNumber ; 
int episodeNumber ; 


void skipIntro() { 
System.out.println ("Skipping intro..."); 
} 


void skipToNext() { 


System.out.println ("Loading next episode.. 


} 
} 


class EpisodeTestDrive { 
public static void main(String[] args) { 


Episode episode = new Episode () ; 
episode.seriesNumber = 4; 
episode.play() ; 
episode.skipIntro() ; 


Fa Be 


classes and objects 


Code Magnets ————> Answers on page 46. 


A Java program is all scrambled up on 
d.playSnare(); 


the fridge. Can you reconstruct the 

code snippets to make a working Java 

program that produces the output listed 

below? Some of the curly braces fell on 

the floor and they were too small to pick DrumKit d = new DrumKit(); 
up, so feel free to add as many of those 
as you need. 


t = true; 


boolean topHa 


poolean snare =~ true; 


void playSnare() { 


System.out.printin ("bang bang ba-bang"); 


public static void main(String [] args) { 


class DrumKkit { 


void playTopHat () 


{ 
System. out .printin( 


"di i 
ng ding da-dingr) ; 


2 


% java DrumKitTestDrive 


} 


bang bang ba-bang 


ding ding da-ding 
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puzzle: Pool Puzzle 


public class EchoTestDrive { 
public static void main(String [] 


args) { 
ae Echo el = new Echo(); 
a0] Puzzle 
Your job is to take code snippets from int x = 0; 
the pool and place them into the while ( ) { 


blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use : 
all the snippets. Your goal is to a ere 


el.hello(); 


make classes that will compile and e2.count = e2.count + 1; 
run and produce the output listed be- } 
low. Some of the exercises and puzzles LE’ ) { 


in this book might have more than one 
correct answer. If you find another cor- 
rect answer, give yourself bonus points! 


e2.count = e2.count + el.count; 


} 
x =xd¢+ 1; 
Output } 


System.out.printlin(e2.count) ; 


File Edit Window Help Implode 
$java EchoTestDrive 


class { 
int = O; 
void { 
Bonus Question ! System.out.printlin("helloooo... "); 
If the last line of output was } 
24 instead of 10, how would } 


you complete the puzzle? 


Note: Each snippet 
from the pool can be 
used more than once! 


Echo 


e2 x>0 Tester 
count x>1 echo() e2=el; 
el=el+1; count( ) Echo e2; 
el =count + 1; hello() Echo e2 = e1; 
el.count = count + 1; Echo e2 = new Echo(); 


el1.count = e1.count + 1; 
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> Answers on page 47. 


|am compiled from a .java file. 


classes and objects 


A bunch of Java components, in full costume, are playing a party 
game, “Who am I?” They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be 
true for more than one of them, choose all for whom that sentence 
can apply. Fill in the blanks next to the sentence with the names of 
one or more attendees. The first one’s on us. 


Tonight's attendees: 


Class Method Object Instance variable 


class 


My instance variable values can 
be different from my buddy’s 
values. 


| behave like a template. 


| like to do stuff. 


| can have many methods. 


| represent “state.” 


| have behaviors. 


| am located in objects. 


I live on the heap. 


| am used to create object instances. 


My state can change. 


| declare methods. 


| can change at runtime. 


—————> Answers on page 47. 


you are here > 


45 


exercise solutions 


Code Magnets (from page 43) 


class DrumKit { 
boolean topHat = true; 
boolean snare = true; 


void playTopHat() { 
System.out.println("ding ding da-ding"); 


void playSnare() { 
System.out.printin("bang bang ba-bang") ; 


class DrumKitTestDrive { 
public static void main(String[] args) { 
DrumKit d = new DrumKit(); 
d.playSnare(); 
d.snare = false; 
d.playTopHat (); 


if (d.snare == true) { 
d.playSnare(); 


File Edit Window Help Dance 


% java DrumKitTestDrive 


bang bang ba-bang 


ding ding da-ding 
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BE the Compiler (from page 42) 


class StreamingSong { 
String title; 
String artist; 
int duration; 


A void play() { 
System.out.println("Playing song"); 
} 


void printDetails() { 
System.out.println("This is " + title + 
"by " + artist); 


} We've got the template, 


} have to make an object! on 


class StreamingSongTestDrive { 
public static void main(String[] args) { 


StreamingSong song = new StreamingSong(); 


song.artist = "The Beatles"; 
song.title = "Come Together"; 
song.play(); 


song.printDetails(); 


class Episode { 0: 
int seriesNumber; The line: episode Play . ; lay 
int episodeNumber; wouldn't compile withou 


hod in the episode Class. 
void play() { me: 
System.out. printin("Playing episode "4 episodeNiwniber); 


void skipIntro() { 
System.out.println("Skipping intro..."); 
} 


void skipToNext() { 
System.out.println ("Loading next episode..."); 


} 


B class EpisodeTestDrive { 
public static void main(String[] args) { 
Episode episode = new Episode (); 
episode.seriesNumber = 4; 
episode.play(); 
episode.skipIntro(); 


KE Puzzle Solutions 


Poo] Puzzle (from page 44) 


public class EchoTestDrive { 


public static void main(String[] 


args) { 
Echo el = new Echo(); 
Echo e2 = new Echo(); // correct answer 
- or - 
Echo e2 = e1; // bonus "24" answer 
int x = 0; 
while (x<4) { 
el.hello(); 
e1.count = e1.count + 1; 
Lf (x==3) 4 
e2.count = e2.count + 1; 
} 
if (x>0) { 
e2.count = e2.count + el.count; 


} 
x =x 41; 
} 


System.out.printin(e2.count) ; 


class Echo { 
int count = 0; 


void hello() { 
System.out.printin("helloooo... "); 


File Edit Window Help Assimilate 


$java EchoTestDrive 


helloooo... 
helloooo... 
helloooo... 
helloooo... 
10 


Who Am [? (from page 45) 


|! am compiled from a .java file. 


classes and objects 


class 


My instance variable values can be 


different from my buddy’s values. 
| behave like a template. 

| like to do stuff. 

| can have many methods. 

| represent “state.” 

| have behaviors. 

| am located in objects. 

| live on the heap. 


| am used to create object 
instances. 


My state can change. 
| declare methods. 


| can change at runtime. 


object 

class 

object, method 

class, object 

instance variable 

object, class 

method, instance variable 
object 


class 
object, instance variable 
class 


object, instance variable 


Note: both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to “have” 
them. Right now, we don't care where they technically live. 
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3 primitives and references 


Know Your Variables 


bed. hie 
4. efghijklmnoparstuvwxyrs 
fy \ 


D : 
eclarations and Assignments | 


F 
| Sane eining 


int % 


float 2 = 3.1416. 


Se TR Ti 


long y = x + 3. 


Variables can store two types of things: primitives and references. 
So far you've used variables in two places—as object state (instance variables) and as local 
variables (variables declared within a method). Later, we'll use variables as arguments (values 
sent to a method by the calling code), and as return types (values sent back to the caller of the 
method). You've seen variables declared as simple primitive integer values (type int). You've 
seen variables declared as something more complex like a String or an array. But there’s gotta 
be more to life than integers, Strings, and arrays. What if you have a PetOwner object with a 

Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap the mysteries of Java 
types (like the difference between primited and references) and look at what you can declare as a 
variable, what you can putin a variable, and what you can do with a variable. And we'll finally see 


what life is truly like on the garbage-collectible heap. 


this is a new chapter 49 


declaring a variable 


Declaring a variable 


Java cares about type. It won’t let you do 
something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable—what 
happens when someone tries to ask the so-called 
Rabbit to hop () ? And it won’t let you put a 
floating-point number into an integer variable, 
unless you ¢ell the compiler that you know you might 
lose precision (like, everything after the decimal 
point). 


The compiler can spot most problems: 
Rabbit hopper = new Giraffe() ; 
Don’t expect that to compile. Thankfully. 


For all this type-safety to work, you must declare 

the type of your variable. Is it an integer? a Dog? 

A single character? Variables come in two flavors: 
primitive and object reference. Primitives hold 
fundamental values (think: simple bit patterns) 
including integers, booleans, and floating-point num- 
bers. Object references hold, well, references to objects 
(gee, didn’t that clear it up). 


We'll look at primitives first and then move on 
to what an object reference really means. But 
regardless of the type, you must follow two 
declaration rules: 


variables must have a type 


Besides a type, a variable needs a name so that you 
can use that name in code. 


é CEs) 
Variable & = variables must have a name 


int count; 


bye ae 


Note: When you see a statement like: “an object of 
type X,” think of éype and class as synonyms. (We’ll 
refine that a little more in later chapters.) 
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“I'd like a double mocha, no, make it an int.” 


When you think of Java variables, think of cups. Coffee cups, tea cups, giant cups 
that hold lots and lots of your favorite drink, those big cups the popcorn comes in 
at the movies, cups with wonderful tactile handles, and cups with metallic trim that 
you learned can never, ever go in the microwave. 


A variable is just a cup. A container. It holds something. 


It has a size and a type. In this chapter, we’re going to look first at the variables 
(cups) that hold primitives: then a little later we'll look at cups that hold references 
to objects. Stay with us here on the whole cup analogy—as simple as it is right 

now, it’ll give us a common way to look at things when the discussion gets more 
complex. And that'll happen soon. 


Primitives are like the cups they have at the coffee shop. If you’ve been to a 
Starbucks, you know what we’re talking about here. They come in different sizes, 
and each has a name like “short,” “tall,” and, “Td like a ‘grande’ mocha half-caff 


with extra whipped cream.” 
You might see the cups displayed on the counter so you 
can order appropriately: ] 


small short tall grande 
And in Java, primitives come in different sizes, and those sizes have 
names. When you declare any variable in Java, you 
must declare it with a specific type. The four 
_ containers here are for the four integer 
0 primitives in Java. 
long int short byte 


Each cup holds a value, so for Java primitives, rather than saying, “Td like a tall 
french roast,” you say to the compiler, “Id like an int variable with the number 90 
please.” Except for one tiny difference...in Java you also have to give your cup a 
name. So it’s actually, “Pd like an int please, with the value of 2486, and name the 
variable height.” Each primitive variable has a fixed number of bits (cup size). 
The sizes for the six numeric primitives in Java are shown below: 


sou 


byte short int long float double 
8 16 32 64 32 64 


primitives and references 


Primitive Types 
Type BitDepth Value Range 


boolean and char 


boolean UVM-specific) true or false 
char 16 bits 0 to 65535 


numeric (all are signed) 


integer 

byte 8bits -128to127 

short 16 bits -32768 to 
32767 

int 32 bits -2147483648 
to 2147483647 


long 64bits -huge to huge 


floating point 


float 32 bits varies 
double 64bits varies 


Primitive declarations 


with assignments: 


int x; 

x = 234; 

byte b = 89; 

boolean isFun = true; 
double d = 3456.98; 
char c = ‘f’; 

int z= x; 

boolean isPunkRock; 
isPunkRock = false; 
boolean powerOn; 
powerOn = isFun; 
long big = 34567891; 
flodt = 32,57 


a ) 
Note the ‘f and ‘Le wae i. 
some number types» YO . 
specifically tell the ae 
what you mean, OF ib mig a 
et tonfused between sim! . 
ane number types: You 


use wpper OF lowertase: 
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primitive assignment 


You really don't want to spill that... 


Be sure the value can fit into the variable. 


You can’t put a large value into a 
small cup. 


Well, OK, you can, but you'll lose 
some. You'll get, as we say, spillage. 
The compiler tries to help prevent 
this if it can tell from your code 
that something’s not going to fit in 
the container (variable/cup) you’re 
using. 


For example, you can’t pour an 
int-full of stuff into a byte-sized 
container, as follows: 

int x = 24; 
byte b= x; 


//won't work!! 


Why doesn’t this work, you ask? After all, the value of x 1s 24, and 24 is definitely small 
enough to fit into a byte. You know that, and we know that, but all the compiler cares 


about is that you’re trying to put a big thing into a small thing, and there’s the possebility 


of spilling. Don’t expect the compiler to know what the value of « is, even if you happen 


to be able to see it literally in your code. 


You can assign a value to a variable in one of several ways including: 


M@ type a Heral value after the equals sign (x=12, isGood = true, etc.) 


M@ assign the value of one variable to another (x = y) 


Muse an expression combining the two (x = y + 43) 


In the examples below, the literal values are in bold italics: 


int size = 


32; 
char initial = 'j'; 
double d = 456.709; 


boolean isLearning; 


isLearning = true; 


x + 456; 


int y= 


declare an int named size, assign it the value 32 
declare a char named initial, assign it the value {’ 
declare a double named d, assign it the value 456.709 
declare a boolean named isCrazy (no assignment) 
assign the value true to the previously declared isCrazy 


declare an int named y, assign it the value that is the sum 


of whatever x is now plus 456 
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Ge sharpen your pencil 
ren yer P 


The compiler won't let you put 
a value from a large cup into 

a small one. But what about 
the other way—pouring a 
small cup into a big one? No 
problem. 


Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren't. 
We haven't covered all the 
rules yet, so on some of these 
you'll have to use your best 
judgment. Tip: The compiler 
always errs on the side of 
safety. 


From the following list, Circle 
the statements that would be 
legal if these lines were in a 

single method: 


. int x= 


. boolean 


. int g = 


. int y = 


. byte b 
. byte v 


10. short 


11. v=n; 


12. byte k = 128; 


——> Answers an page 68. 


primitives and references 


Back away from that keyword! 


You know you need a name and a type for your variables. 
You already know the primitive types. 


But what can you use as names? The rules are simple. 
You can name a class, method, or variable according to the 
following rules (the real rules are slightly more flexible, but 

these will keep you safe): 


H@ It must start with a letter, underscore (_), or 
dollar sign ($). You can’t start a name with a 
number. 


H After the first character, you can use numbers as 
well. Just don’t start it with a number. 


@ It can be anything you like, subject to those two 
rules, just so long as it isn’t one of Java’s reserved 


ou 
words. If you ah aie 
Reserved words are keywords (and other things) that the compiler Sale eas 
recognizes. And if you really want to play confuse-a-compiler, then 


just éry using a reserved word as a name. 


No matter what 
you hear, do not, I 
repeat, do not let me 
ingest another large 
furry dog. 


doy, ‘t 
You've already seen some reserved words: to Se 9 
r NY o f 
—— Your ow y th es 
in nam ¢ 


public static void 
And the primitive types are reserved as well: 


boolean char byte short int long float double 


But there are a lot more we haven’t discussed yet. Even if you don’t 

need to know what they mean, you still need to know you can’t use *em 
yourself. Do not—under any circumstances—try to memorize these 
now. ‘To make room for these in your head, you’d probably have to lose 
something else. Like where your car is parked. Don’t worry, by the end of 
the book you'll have most of them down cold. 


This table reserved 


fessert [ess [enum [gore _]long [public | srehronized [void | 
foyte_[aefautt [nat [import [nal [static [throws |__| 
[ease [ao [finaly | metonceot [package [atrctfp [transienr [ | 


Java’s keywords, reserved words, and special identifiers. If you use these for names, the compiler will probably be very, very upset. 
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object references 


Controlling your Dog object 


You know how to declare a primitive variable and assign it a value. 
But now what about non-primitive variables? In other words, what 


about objects? Dog d = new Dog(); 
d.bark(): 


™ There is actually no such thing as an object variable. 


mM There’s only an object reference variable. think of this 


H An object reference variable holds bits that represent a lik thi 
way to access an object. Ke 1S 


MH It doesn’t hold the object itself, but it holds something 
like a pointer. Or an address. Except, in Java we don’t 
really know whatis inside a reference variable. We do 
know that whatever it is, it represents one and only one 
object. And the JVM knows how to use the reference to 
get to the object. 


You can’t stuff an object into a variable. We often think of it that 
way...we say things like, “I passed the String to the System.out. 
println() method.” Or, “The method returns a Dog” or, “I put a new 
Foo object into the variable named myFoo.” 


But that’s not what happens. There aren’t giant expand- 
able cups that can grow to the size of any object. 


. Think of a Dos, 


Objects live in one place and one place only—the AN | veference variable as 


garbage-collectible heap! (You'll learn more about 


that later in this chapter) a Dog remote control. 


% You use it to get the 
y object to do something 
(invoke methods). 


Although a primitive variable is full of bits 
representing the actual value of the variable, 
an object reference variable is full of bits 
representing a way to get to the 
object. 


You use the dot operator (.) on a ref- 
erence variable to say, “use the thing 
before the dot to get me the thing after 
the dot.” For example: 


myDog. bark () ; 


means, “use the object referenced by the variable myDog to invoke 
the bark() method.” When you use the dot operator on an object 
reference variable, think of it like pressing a button on the remote 
control for that object. 
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sou 


byte short int long reference 
8 = 16 32 64 — (bit depth not relevant) 


An object reference is just 
another variable value 


Something that goes in a cup. 
Only this time, the value is a remote control. 


Primitive Variable o> 
= 7: ge 
BYES Sets primitive 
The bits representing 7 go value 
into the variable (00000111). 
byte 

Reference Variable ra 

mv) 
Dog myDog = new Dog() ; Dog? 
The bits representing a way to get to 4 <~ 
the Dog object go into the variable. veferente 
The Dog object itself does not go into value 


the variable! 


With primitive variables, the value of the vari- 
able is...the value (5, -26.7, ‘a’). 


With reference variables, the value of the 
variable is...bits representing a way to get to a 
specific object. 


You don’t know (or care) how any particular 
JVM implements object references. Sure, they 
might be a pointer to a pointer to...but even 
if you know, you still can’t use the bits for 
anything other than accessing an object. 


We don’t care how many 1s and Os there are in a reference variable. It’s 
up to each JVM and the phase of the moon. 


primitives and references 


The 3 steps of object 
declaration, creation and 


assignment 
1 2 
Dog myDog = new Dog() ; 


Declare a reference 
variable 


Dog myDog = new Dog() ; 


Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button Dog 
or a Socket. 


2) Create an object 


Dog myDog = new Dog() ; 


Tells the JVM to allocate space for a 
new Dog object on the heap (we'll 
learn a lot more about that process, 
especially in Chapter 9, Life and Death 


of an Object). Dog object 


Link the object 
and the reference 


Dog myDog = new Dog(); 


Assigns the new Dog to the reference 
variable myDog. In other words, 
programs the remote control. 


Dog object 
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object references 


there, are_no 


Dumb Questions 


Q: How big is a reference 
variable? 


A: You don’t know. Unless 
you're cozy with someone on the 
JVM's development team, you 
don't know how a reference is 
represented. There are pointers 
in there somewhere, but you 
can’t access them. You won't 
need to. (OK, if you insist, you 
might as well just imagine it 

to be a 64-bit value.) But when 
you're talking about memory 
allocation issues, your Big 
Concern should be about how 
many objects (as opposed to 
object references) you're creating 
and how big they (the objects) 
really are. 


Q: So, does that mean that 

all object references are the 
same size, regardless of the size 
of the actual objects to which 
they refer? 


A: Yep. All references for a 
given JVM will be the same 


size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 


Q: Can | do arithmetic ona 
reference variable, increment 
it, you know—C stuff? 


A: Nope. Say it with me again, 
“Java is not C” 
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Java Exposed 


This week’s interview: 
Object Reference 


HeadFirst: So, tell us, what’s life like for an object reference? 


Reference: Pretty simple, really. ’m a remote control, and I can be programmed to 
control different objects. 


HeadFirst: Do you mean different objects even while you’re running? Like, can you 
refer to a Dog and then five minutes later refer to a Car? 


Reference: Of course not. Once I’m declared, that’s it. If ’m a Dog remote control, 
then [ll never be able to point (oops—ny bad, we’re not supposed to say point), I mean, 
refer to anything but a Dog. 

HeadFirst: Does that mean you can refer to only one Dog? 


Reference: No. I can be referring to one Dog, and then five minutes later I can refer to 
some other Dog, As long as it’s a Dog, I can be redirected (like reprogramming your remote 
to a different TV) to it. Unless...no never mind. 


HeadFirst: No, tell me. What were you gonna say? 


Reference: I don’t think you want to get into this now, but I’ll just give you the short 
version—1if I’m marked as final, then once I am assigned a Dog, I can never be repro- 
grammed to anything else but état one and only Dog, In other words, no other object can 
be assigned to me. 


HeadFirst: You're right, we don’t want to talk about that now. OK, so unless you’re 
final, then you can refer to one Dog and then refer to a different Dog later. Can you ever 
refer to nothing at all? Is it possible to not be programmed to anything? 


Reference: Yes, but it disturbs me to talk about it. 

HeadFirst: Why is that? 

Reference: Because it means I’m nu11, and that’s upsetting to me. 
HeadFirst: You mean, because then you have no value? 


Reference: Oh, nul] isa value. I’m still a remote control, but it’s like you brought 
home a new universal remote control and you don’t have a TV. I’m not programmed to 
control anything. They can press my buttons all day long, but nothing good happens. I 
just feel so...useless. A waste of bits. Granted, not that many bits, but still. And that’s not 
the worst part. If Iam the only reference to a particular object and then I’m set to null 
(deprogrammed), it means that now nobody can get to that object I had been referring to. 


HeadFirst: And that’s bad because... 


Reference: You have to ask? Here I’ve developed a relationship with this object, an 
intimate connection, and then the tie is suddenly, cruelly, severed. And I will never see 
that object agai, because now it’s eligible for [producer, cue tragic music] garbage collection. 
Sniff’ But do you think programmers ever consider éhal? Snif. Why, why can’t I be a primi- 
tive? I hate being a reference. The responsibility, all the broken attachments... 


primitives and references 


Life on the garbage-collectible heap 


Book b 


new Book () ; 


Book c new Book () ; 


Declare two Book reference 
variables. Create two new Book 
objects. Assign the Book objects to 
the reference variables. 


The two Book objects are now living 
on the heap. 


References: 2 
Objects: 2 


Book 


Book d = c; 


Declare a new Book reference variable. 
Rather than creating a new, third Book 
object, assign the value of variable c to 
variable d. But what does this mean? 

It's like saying “Take the bits in c, make a 
copy of them, and stick that copy into d." 


Both c and d refer to the same 
object. 


The c and d variables hold 
two different copies of the 
same value. Two remotes 
programmed to one TV. 


References: 3 
Objects: 2 


c=b; 


Assign the value of variable 6 to 
variable c. By now you know what 
this means. The bits inside variable 
b are copied, and that new copy is 
stuffed into variable c. 


Both b and c refer to the 
same object. 


The c variable no longer 
refers to its old Book 
object. 


References: 3 
Objects: 2 
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objects on the heap 


Life and death on the heap 


—— -~@ 


Book b 


Book c new Book () ; 


Declare two Book reference variables. 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 


The two book objects are now living 
on the heap. 


Active References: 2 
Reachable Objects: 2 


Book 


b=c; 


Assign the value of variable c to variable b. 
The bits inside variable ¢ are copied, and 
that new copy is stuffed into variable b. 
Both variables hold identical values. 


Both b and c refer to the same 
object. Object 1 is abandoned 
and eligible for Garbage Collec- 
tion (GC). 


Active References: 2 
Reachable Objects: 1 
Abandoned Objects: 1 


The first object that b referenced, Object 1, 
h f It! hable. 
as no more references. It’s unreachable Book 


c = null; 


Assign the value nu11 to variable c. 
This makes ¢ a null reference, meaning 
it doesn’t refer to anything. But it’s still 
a reference variable, and another Book 
object can still be assigned to it. 


Object 2 still has an active 
reference (b), and as long 
as it does, the object is not 
eligible for GC. 


Active References: 1 
null References: 1 
Reachable Objects: 1 
Abandoned Objects: 1 
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An array is like a tray of cups 


The Java standard library includes lots of sophisticated 
data structures including maps, trees, and sets (see 
Appendix B), but arrays are great when you just want a 
quick, ordered, efficient list of things. Arrays give you fast 
random access by letting you use an index position to get 
to any element in the array. 


Every element in an array is just a variable. In other 
words, one of the eight primitive variable types (think: 
Large Furry Dog) or a reference variable. Anything you 
would put in a variable of that type can be assigned to an 


Declare an int array variable. An array variable is 


a remote control to an array object. 
int[] nums; 


primitives and references 


array element of that type. So in an array of type int (int[]), 
each element can hold an int. In a Dog array (Dog|[]) each 
element can hold...a Dog? No, remember that a reference 
variable just holds a reference (a remote control), not the 
object itself: So in a Dog array, each element can hold a 
remote control to a Dog. Of course, we still have to make the 
Dog objects...and you'll see all that on the next page. 


Be sure to notice one key thing in the picture—the 
array is an object, even though it’s an array of 
primitives. 


Arrays are always objects, 
whether they're declared to 
hold primitives or object 


Create a new int array with a length 
of 7, and assign it to the previously 
declared int [] variable nums 


2 | 


references. 


hums = 


Give each element in the array 
some int value. 

Remember, elements in an int 
array are just int variables. 


¢ 

= nums[0] = 6; 
= \ nums[1] = 19; 
¥® nums[2] = 44; 
ce nums[3] = 42; 
nums[4] = 10; 
nums[5] = 20; 
nums[6] = 1; 


Arrays are objects too 


new int[7]; 


7 int variables 


aTonMTSTaTaN 


int 


int int int int int int 


int array object (int[]) 


Notice that the array itself is an object, 
even though the 7 elements ave primitives. 


You can have an array object that’s declared to hold primitive values. In other words, the 
array object can have elements that are primitives, but the array itself is never a primitive. 
Regardless of what the array holds, the array itself is always an object! 
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an array of objects 
Make an array of Dogs 


Declare a Dog array variable 
Dog[] pets; 


Create a new Dog array with 
a length of 7, and assign it to 
the previously declared Dog[] 
variable pets 


new Dog a 


What’s missing? 


Dogs! We have an array 
of Dog references, but no 
actual Dog objects! 


pets = 


Dog Dog Dog Dog Dog 


Dog array object (Dog[]) 
Dog[] 


Create new Dog objects, and 
assign them to the array 03 Obiecy 
elements. S 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 


2? OPjecy 


pets[0] = new Dog(); 
pets[1] = new Dog(); 


—> Yours to solve. 


harpen our pencil 
erry 


What is the current value of 
pets[2]? 


What code would make 
pets[3] refer to one of the 
two existing Dog objects? 


Dog array object (Dog[]) 
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bark() 
eat() 
chaseCat() 


Java cares about type: 


ray, you 
ou’ve declared an ar : 
va ae anything in it except tia 
‘nat are of a compatible array ype: 


an't put a Cat into a Dog 


pretty awful if someone 
in the array, SO — 
thinks that only Does eet and then to their 


horror discover 
you cant stick a dou 
illage, remember? ). 
ie into an int array, because a byte 
ill always fit into an ine = 
eave as an implicit widening. ae 
the details later: for now just he es 
that the compiler won't let ee Pt iene 
wrong thing in an array, based 0 


declared type. 


primitives and references 


Control your Dog 


(with a reference variable) 
Dog fido = new Dog(); 


fido.name = "Fido"; 


We created a Dog object and used 
the dot operator on the reference 
variable fido to access the name 
variable.* 


We can use the fido reference to 
get the dog to bark() or eat() or 
chaseCat(). 


fido .bark () ; 
fido.chaseCat () ; 


What happens if the Dog is in 
a Dog array? 


We know we can access the Dog’s instance 
variables and methods using the dot 
operator, but on what? 


When the Dog is in an array, we don’t have 
an actual variable name (like fido). Instead 
we use array notation and push the remote 
control button (dot operator) on an object 

at a particular index (position) in the array: 


Dog[] myDogs = new Dog[3]; 
myDogs[0] = new Dog(); 
myDogs[0].name = "Fido"; 


myDogs [0] .bark() ; 


*Yes we know we're not demonstrating encapsulation here, but we're 
trying to keep it simple. For now. We'll do encapsulation in Chapter 4. 
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using references 


class Dog { 
String name; 
{ 


public static void main(String[] args) 


// make a Dog object and access it 


Dog dogl = new Dog(); etal type 
dogl.bark(); Strings are 4 vee eveate 
dogl.name = "Bart"; <“~—__— of objyett- You © they 
and assign eae {hou} 
pears & even 
// now make a Dog array were primitives ; 
ve vegerences/: 
Dog[] myDogs = new Dog[3]; they re 
// and put some dogs in it 
myDogs[0] = new Dog(); 
myDogs[1] = new Dog(); 
myDogs[2] = dogl; 


// now access the Dogs using the array 
// veferences 


myDogs[0].name = "Fred"; 

myDogs[1].name = "Marge"; 

// Hmmmm... what is myDogs[2] name? 
System.out.print ("last dog’s name is "); 


System.out.printin(myDogs [2] .name) ; 


// now loop through the array 
// and tell all dogs to bark 


int x = 0; 
while (x < myDogs.length) { ; 
myDogs [x] .bark(); ; enath 
_ : io hav a variable | ar 
7 ; red ew 
hat ges vou BE 
} keqee er 
elemen 
public void bark() { 
System.out.println(name + " says Ruff!"); 


public void eat() { 


} 


public void chaseCat() { 


} 
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-——— BULLET POINTS 


A Dog example 


Dog 


name 


bark() 
eat() 
chaseCat() 


Output 

| File Edit Window Help Howl 
Sjava Dog 

null says Ruff! 

last dog’s name is Bart 
Fred says Ruff! 


Marge says Ruff! 


Bart says Ruff! 


Variables come in two flavors: primitive and 
reference. 


Variables must always be declared with a name 
and a type. 

A primitive variable value is the bits representing 
the value (5, ‘a’, true, 3.1416, etc.). 


A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

A reference variable is like a remote control. 
Using the dot operator (.) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 


A reference variable has a value of nu11 when 
it is not referencing any object. 


An array is always an object, even if the array 
is declared to hold primitives. There is no such 
thing as a primitive array, only an array that 
holds primitives. 


primitives and references 


BE the Compiler 


Each of the Java files on this page 

. Fepresents a complete source file. 

,. Your job is to play compiler and 

, determine whether each of these 
files will compile and run 
without exception. If 
they won’t, how would 
you fix them? 


A B 
class Books { class Hobbits { 
String title; String name; 
String author; 
} public static void main(String[] args) { 
Hobbits[] h = new Hobbits [3]; 
class BooksTestDrive { int z = 0; 


public static void main(String[] args) { 


Books[] myBooks = new Books[3]; while (z < 4) { 
int x = 0; z=zt 1; 
myBooks[0].title = "The Grapes of Java"; h[z] = new Hobbits(); 
myBooks[1].title = "The Java Gatsby"; h[z].name = "bilbo"; 
myBooks[2].title = "The Java Cookbook"; if (z == 1) { 
myBooks[0].author = "bob"; h[{z].name = "frodo"; 
myBooks[1].author = "sue"; } 
myBooks[2].author = "ian"; if (z == 2) { 
h[z].name = "sam"; 
while (x < 3) f{ } 
System.out. print (myBooks[x].title); System.out.print(h[z].name + "is a"); 
System.out.print(" by "); System.out.println("good Hobbit name"); 
System. out.println (myBooks[x].author) ; } 
x=xt1; } 


————— > Answers on page 68. 
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exercise: Code Magnets 


Code Magnets 


A working Java program is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 


ref = index[y]; 


int ref; 


while (y < 4) 


System.out.println(islands[ref]); 


= 1; 


index [0] 


index{1] = 3i 
index(21 = 97 
= 2; 


index [31 


String [] islands = new String[4]; 


System.out.print ("island = "); 


new int[4]; 


File Edit Window Help Sunscreen 


% java TestArrays 
island = Fiji 
island = Cozumel 
island Bermuda 
island = Azores 


class TestArrays { 


public static voig Main(String [] args) 


{ 
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Poo] Puzzle 


Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make a class that will compile and 
run and produce the output listed. 


Output 


File Edit Window Help Bermuda 
S$java Triangle 


triangle 0, area 4.0 
triangle 1, area 
triangle 2, area 
triangle 3, area 


va 


Bonus Question! 


For extra bonus points, use snippets 
from the pool to fill in the missing 
output (above). 


NJTriangle [] ta = new Triangle[4]; 


————> Answers on page 69. 


4, t5 area = 18.0 
4, t5 area = 343.0 


area : 
27,t5 area = 18.0 int x; : 
ta.area 7 no z 
$e ncend 27,t5 area = 343.0 ne y; ; X=X+ 7 ta.x 
Int X =Q; X=x+2: 

ta[x].area : f ta(x) 
7 [x] ta[x] = setArea(); intx =1; X=x-1; talx] x<4 
Triangle [] ta=newTriangle(4); tax=setArea(); int y =x; 
Triangle ta = new [] Triangle[4]; talx].setArea(); 28.9 ta=newTriangle(); 


primitives and references 


class Triangle { rk yse a separate 


s day 
double area; (Sometimes we do eve tryin to 
int height; Lest class: because . 
f he Pa9e 
int length; save space OP ee 


public static void main(String[] args) { 


while ( ) { 


-height = (x + 1) * 2; 
. length 


T 
x 
i" 

= 


System.out.print ("triangle "+x +", area"); 


System.out.printin(" = "+ -area); 


x = 27; 

Triangle t5 = ta[2]; 
ta[2].area = 343; 
System.out.print("y = " + y); 


System.out.println(", t5 area = " + t5.area); 
} 


void setArea() { 


= (height * length) / 2; 


Note: Each snippet 
from the pool can be 
used more than once! 


30.0 ta[x] = new Triangle(); 
: ta.x = new Triangle();_ 
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puzzle: Heap o’ Trouble 


A Heap o' Trouble 


A short Java program is listed to the 
right. When “// do stuff” is reached, 
some objects and some reference vari- 
ables will have been created. Your task 
is to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used, and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 


Tip: Unless you're way smarter than we 
are, you probably need to draw dia- 
grams like the ones on page 57-60 of 
this chapter. Use a pencil so you can 
draw and then erase reference links (the 
arrows going from a reference remote 
control to an object). 


Match €@ 
variable wt 
dbjett!s). 


You might not have i 


erence: 


use every ve 


————+ Answers on page 69. 
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th vex erence 


fh matching 


class HeapQuiz { 
int id = 0; 


public static void main(String[] args) { 
int x = 0; 
HeapQuiz[] hq = new HeapQuiz[5]; 
while (x < 3) { 
hq[x] = new HeapQuiz(); 
hq[x].id = x; 
=x 4+ 1; 


hq[3] = hq[1]; 
hq[4] = hg[1]; 
hq[3] = null; 
hq[4] = hq[0]; 
hq[0] = hq[3]; 
hq[3] = hq[2]; 

[ = ha[0]; 
// do stuff 


Reference Variables: HeapQuiz Objects: 


primitives and references 


The case of the pilfered references 


It was a dark and stormy night. Tawny strolled into the programmers’ bullpen like she owned 
the place. She knew that all the programmers would still be hard at work, and she wanted help. 
She needed a new method added to the pivotal class that was to be loaded into the client’s 
new top-secret Java-enabled cell phone. Heap space in the cell phone’s memory was tight, and 
everyone knew it. The normally raucous buzz in the bullpen fell to silence as Tawny eased her 
way to the white board. She sketched a quick overview of the new method’s functionality and 
slowly scanned the room. “‘Well folks, it’s crunch time,” she purred. “Whoever creates the most 
2 2 memory efficient version of this method is coming with me to the client’s launch party on Maui 
Five-Minute tomorrow...to help me install the new software.” . is 


Myster > The next morning Tawny glided into the bullpen. “Ladies and Gentlemen,” she smiled, 
“the plane leaves in a few hours, show me what you’ve got!” Bob went first; as he 
began to sketch his design on the white board, Tawny said, “Let’s get to the point Bob, 
show me how you handled updating the list of contact objects.” Bob quickly drew a 
code fragment on the board: 


Contact [] contacts = new Contact[10]; 

while (x < 10) { // make 10 contact objects 
contacts[x] = new Contact (); 
x= xt+ 1; 

} 

// do complicated Contact list updating with contacts 


“Tawny, I know we’re tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts; this was the best scheme I could 
cook up,” said Bob. Kate was next, already imagining coconut cocktails at the party, “Bob,” 
she said, “‘your solution’s a bit kludgy, don’t you think?” Kate smirked, “Take a look at this 
baby”: 


Contact contactRef; 

while (x < 10) { // make 10 contact objects 
contactRef = new Contact (); 
x = xt+ 1; 

} 

// do complicated Contact list updating with contactRef 


“T saved a bunch of reference variables worth of memory, Bob-o-rino, so put away your 
sunscreen,” mocked Kate. “Not so fast Kate!” said Tawny, “you’ve saved a little memory, but 
Bob’s coming with me.” 


Why did Tawny choose Bob’s method over Kate’s, when Kate’s used less memory? 


> 
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exercise solutions 


| SoLutions 


Sharpen your pencil (from page 52) 


Code Magnets (from page 64) 


class TestArrays { 
public static void main (String[] 


int[] index = new int[4]; 
index[0] = 1; 
index[1] = 3; 
index[2] = 0; 
index[3] = 2; 
String[] islands = new String[4]; 
islands[0] = "Bermuda"; 
islands[1] = "Fiji"; 
islands[2] = "Azores"; 
islands[3] = "Cozumel"; 

0 


int y = 
int ref; 
ly < 4) { 

ref = index[y]; 


while 


System.out.print ("island = "); 


1. int x = 34.5; K 7. s=yviXk 

2. boolean boo = x;K 8. byte b = 3;YW 

34. nb gg S17 9. byte v = bi Y% 

Ae ane yy = Grey 10. short n = 12;\/f 
5. y=zyt LAY li, v = ne XK 

6. short <7 y 12. byte k = 128;% 


args) { 


System.out.printin(islands[ref]); 


Vow Ly 


} File Edit Window Help Sunscreen 


TestArrays 
Fiji 


% java 
island = 
island = 
island 
island 


Cozumel 
Bermuda 
Azores 
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BE the Compiler (from page 63) 


class Books { 


} 


String title; 
String author; 


class BooksTestDrive { 


} 


public static void main(String[] args) { 


Books[] myBooks = new Books[3]; 


int x = 0; ber We have %9 
myBooks[0] = new Books(); ae ‘ake the Book 
myBooks[1] = new Books(); 2° cha ie 
myBooks[2] = new Books(); a al 


myBooks[0].title = "The Grapes of Java"; 
myBooks[1].title = "The Java Gatsby"; 
myBooks[2].title = "The Java Cookbook"; 
myBooks[0].author = "bob"; 
myBooks[1].author = "sue"; 
myBooks[2].author = "ian"; 

while (x < 3) f{ 


System.out.print (myBooks[x].title); 
System.out.print(" by "); 
System.out.println (myBooks[x].author) ; 


x=xt+1; 


class Hobbits { 


String name; 


public static void main(String[] args) { 


Hobbits[] h = new Hobbits[3]; 
int z = -1; einénba: 
while (z< 2){ with lege is start 
ZS oT te 
h[z] = new Hobbits (); 
h[z].name = "bilbo"; 
1f o(Z == 1) 
h[{z].name = "frodo"; 
} 
if (z == 2) { 
h[{z].name = "sam"; 


System.out.print(h[z].name + "is a"); 
System.out.println ("good Hobbit name") ; 


ISR Puzzle Solutions 


Pos 


a] Puzzle (from page 65) 


class Triangle { 
double area; 
int height; 
int length; 


public static void main(String[] args) { 


} 


int x = 0; 
Triangle[] ta = new Triangle[4]; 
while (x<4) { 
ta[x] = new Triangle(); 
talx].height = (x + 1) * 2; 
ta[x]. length = x + 4; 
ta[x].setArea(); 
System.out.print ("triangle "+ x + 


", area"); 
System.out.printin(" = " + talx].area) ; 
x=x+1; 

} 
int y =x; 
xX = 27; 


Triangle t5 = ta[2]; 

ta[2].area = 343; 

System.out.print("y =" + y); 

System.out.printlin(", t5 area = " + 
t5.area); 


void setArea() { 


} 


area = (height * length) / 2; 


File Edit Window Help Bermuda 


$java Triangle 

triangle area = 4.0 
triangle area = 10.0 
triangle area = 18.0 
area = 28.0 


triangle 
y = 4, t5 area = 343.0 


primitives and references 


Five-Minute Mystery 
(from page 67) 


The case of the pilfered references 


Tawny could see that Kate’s method had a serious flaw. 
It’s true that she didn’t use as many reference variables 
as Bob, but there was no way to access any but the last 
of the Contact objects that her method created. With each 
trip through the loop, she was assigning a new object 
to the one reference variable, so the previously refer- 
enced object was abandoned on the heap—unreachable. 
Without access to nine of the ten objects created, Kate’s 
method was useless. 

(The software was a huge success, and the client gave Tawny and Bob an extra 


week in Hawaii. We'd like to tell you that by finishing this book you too will get stuff 
like that.) 


A Heap o' Trouble (from page 66) 


Reference Variables: 


HeapQuiz Objects: 
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4 methods use instance variables 


How Objects Behave 


Let's keep those little 
variables private, OK? 


State affects behavior, behavior affects state. We know that objects 

have state and behavior, represented by instance variables and methods. But until now, we 
haven't looked at how state and behavior are related. We already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a name “Fido” and a weight of 70 pounds. Dog B is “Killer” and weighs 9 pounds. 
And if the Dog class has a method makeNoise(), well, don’t you think a 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assuming that annoying yippy sound can be considered 
a bark.) Fortunately, that’s the whole point of an object—it has behavior that acts on its state. In 
other words, methods use instance variable values. Like, “if dog is less than 14 pounds, make 


yippy sound, else...’ or “increase weight by 5.” Let’s go change some state. 
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objects have state and behavior 


Remember: a class describes what an 
object knows and what an object does 


A class is the blueprint for an object. When you 


write a class, you’re describing how the JVM should instance 
make an object of that type. You already know that variables 
every object of that type can have different instance (state) 
variable values. But what about the methods? etTitle 
methods |setarist 
Can every object of that type have different ai new 
: play() 
method behavior? 
Well...sort of-* 
Every instance of a particular class has the same os pscante 
we 


methods, but the methods can behave differently based 
on the value of the instance variables. 


The Song class has two instance variables, tile and 
artist. When you call the play() method on an the 
instance, it will play the song represented by the 
value of the dale and artist instance variables for that 
instance. So, if you call the play() method on one 
instance, you'll hear the song “Havana” by Cabello, 
while another instance plays “Sing” by Travis. The 
method code, however, is the same. 


void play() { 
soundPlayer.playSound(title, artist) ; 


‘ anskante 


Song songl new Song(); 


) on BS. 
Callin, wie to YY 


songl.setArtist ("Travis") ; al pause 


song1.setTitle ("Sing") ; 


Song song2 new Song(); 
song2.setArtist("Sex Pistols") ; 


song2.setTitle("My Way") ; 


*Yes, another stunningly clear answer! 
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My Way 


Sinatra 


Cabello 


y Way 


ex Pistol 


Song 
Song 


sl.play() ; 


s2.play() ; 


\ 


Calling play) on this i 
will cause My Wiv” be cs. 


(but not the Sinatra one). 


methods use instance variables 


The size affects the bark 


A small Dog’s bark is different from a big Dog’s bark. 


The Dog class has an instance variable s¢ze that the bark() 
method uses to decide what kind of bark sound to make. 


@ Bark Different. 


Dog 
class Dog { size 

‘ ‘ name 

int size; 

String name; bark() 

void bark() { 

if (size > 60) { 
System.out.printlin("Wooof! Wooof!"); 


} else if (size > 14) { 
System.out.printlin("Ruff! Ruff!"); 
} else { 


System.out.printlin("Yip! Yip!"); 


class DogTestDrive { 


public static void main(String[] args) { 
Dog one = new Dog(); 

one.size = 70; 

Dog two = new Dog(); 

two.size = 8; 


Dog three = new Dog(); 


three.size = 35; 


one.bark(); 
two.bark(); $java DogTestDrive 
three.bark(); Wooof! Wooof! 
} Yip! Yip! 
: Ruff! Ruff! 
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method parameters 


You can send things to a method 


Just as you expect from any programming language, you can pass values into your 
methods. You might, for example, want to tell a Dog object how many times to 
bark by calling: 


d.bark (3) ; 


Depending on your programming background and personal preferences, you might 
use the term arguments or perhaps parameters for the values passed into a method. 
Although there ave formal computer science distinctions that people who wear lab 
coats (and who will almost certainly not read this book) make, we have bigger fish 
to fry in this book. So you can call them whatever you like (arguments, donuts, hair- 
balls, etc.) but we’re doing it like this: 


A caller passes arguments. A method takes parameters. 


Arguments are the things you pass into the methods. An argument (a value like 
2, Foo, or a reference to a Dog) lands face-down into a...wait for it...parameter. 
And a parameter is nothing more than a local variable. A variable with a type and 
a name that can be used inside the body of the method. 


But here’s the important part: If a method takes a parameter, you must 
pass it something when you call it. And that something must be a value of 
the appropriate type. 
Dog d = new Dog(); 
Call the bark method on the Dog refer- : 
ence, and pass in the value 3 (as the d.bark (3) r 
argument to the method). x. argument 


value 3 are delivered into the 
bark method. 


2) The bits representing the int 


o> 
8) 
Paramete, % The bits land in the numOf Barks 
int parameter (an int-sized variable). 


void bark (int numOfBarks) { 
while (numOfBarks > 0) { 
System.out.princin("rurr™); 


Use the numOf Barks 
parameter as a variable in 
the method code. 


numOfBarks = numOfBarks - 1; 


} 
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methods use instance variables 


You can get things back from a method 


Methods can also return values. Every method is declared with a return 
type, but until now we’ve made all of our methods with a void return 
type, which means they don’t give anything back. 


void go() { 
} 


But we can declare a method to give a specific type of value back to 
the caller, such as: 


Cute... 
but not exactly what I 
was expecting. 
int giveSecret() { 


return 42; 


} 


If you declare a method to return a value, you must return 
a value of the declared type! (Or a value that 1s compatible 
with the declared type. We'll get into that more when we 
talk about polymorphism in Chapters 7 and 8.) 


Whatever you say 
you'll give back, you 
better give back! 


The compiler won't let you return the wrong type of thing, 


int theSecret = life.giveSecret() ; 


1 are returned 


The bits cepresertng dh and \and 


Lyre 
Te \ 
int giveSecret() { 

return 

this must fit 


} in an nT, 
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multiple arguments 


You can send more than one thing 
to a method 


Methods can have multiple parameters. Separate them with 
commas when you declare them, and separate the argu- 
ments with commas when you pass them. Most importantly, 
if a method has parameters, you must pass arguments of the 
right type and order. 


Calling a two-parameter method and sending 
it two arguments 
void go() { 
TestStuff t = new TestStuff() ; 
t.takeTwo(12, 34); 


The ara, 
} he psied Ch Be and 


irs Parameter First argument lands in the 


SeCon 
Paramete,, ahd es ee d argument in the Setond 


void takeTwo(int x, int y) { 
int z=xt+ty; 


System.out.println("Total is " + z); 


You can pass variables into a method, as long as 
the variable type matches the parameter type 


e 
i \ard on & Ove 
void go() { Seo and ot ke ya ne 
int foo = 7; The yalues Lexs- soe 3 (Xe ae wy 
BY Fae ve Wits "Ey, and Ere 
ee Sey syentit se iter be in \av 
t.takeTwo (foo, bar) ; teen A ea bo 
ave 
} 
void takeTwo(int x, int y) { 2 \t's the same 
1, the value ov 2 o + bar 
intz=xty; i. ow d get if you ret ot the 
h ut me You passed wnem 
System.out.println("Total is "+ z); at the™ ; 
Lake Two metne 
} 


76 ~—s chapter 4 


Java is pass-by-value. 


That means pass-by-copy. 


methods use instance variables 


Java 1s 
Pass 
by value 


Wash 


Ereade Cat 
ware ad 
. Chick eh 
Make it — 


d 
Roses are red, 
poem is choppy: 


this 
passing by value 
ee is passing by copy: 
: : ster? Try it. Replace oe 
; Declare an int variable oh, like you can 6° oa your own. Better a 
int x = 7; @ and assign it the value qumb sec sie hing with YO" own words 
int ‘7. The bit pattern for replace the a forget it 
7 goes into the variable and youll® 
named x. 
G] (2) Declare a method with an int 
void go(int z){ } parameter named z. 
int 
“PY of 
o> a Rois 3) Call the go() method, passing 
9 ge the variable x as the argument. 
The bits in x are copied, and 
the copy lands in z. 
int . ; int 
£00.go (x) ; void go(int z){ } 
x doesn’t change Sy and = arent ge 4.) Change the value of z inside 
SNR e does » tonnected go? the method. The value of x 
G] doesn't change! The argument 
Levessessanees Qn passed to the z parameter was 
nae int only a copy of x. 
void go(int 2) { The method can't change the 
z= 0; bits that were in the calling 
, variable x. 
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arguments and return values 


thereareno 
Dumb Questions 


: What happens if the argument you want to 
pass is an object instead of a primitive? 


A: You'll learn more about this in later chapters, 
but you already know the answer. Java passes 
everything by value. Everything. But...value means 
bits inside the variable. And remember, you don't 
stuff objects into variables; the variable is a remote 
control—a reference to an object. So if you pass a 
reference to an object into a method, you're passing 
a copy of the remote control. Stay tuned, though, 
we'll have lots more to say about this. 


Q: Can a method declare multiple return 
values? Or is there some way to return more than 
one value? 


A: Sort of. A method can declare only one return 
value. BUT...if you want to return, say, three int 
values, then the declared return type can be an int 
array. Stuff those ints into the array, and pass it on 
back. It’s a little more involved to return multiple 
values with different types; we'll be talking about 
that in a later chapter when we talk about ArrayList. 


Q: Do I have to return the exact type | declared? 


A: You can return anything that can be implicitly 
promoted to that type. So, you can pass a byte where 
an int is expected. The caller won't care, because the 
byte fits just fine into the int the caller will use for 
assigning the result. You must use an explicit cast 
when the declared type is smaller than what you're 
trying to return (we'll see these in Chapter 5). 


Q: Do | have to do something with the return 
value of a method? Can | just ignore it? 


A: Java doesn’t require you to acknowledge a 
return value. You might want to call a method with 
a non-void return type, even though you don't care 
about the return value. In this case, you're calling 
the method for the work it does inside the method, 
rather than for what the method gives returns. In 


Java, you don't have to assign or use the return value. 
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“Reminder: Java 
cares about type! 


You can’t return a Giraffe when 
the return type is declared 

as a Rabbit. Same thing with 
parameters. You can’t pass a 


eweel a Rabbit. 


Variable = 
& 


-—— BULLET POINTS 


= Classes define what an object knows and what an 
object does. 


= Things an object knows are its instance variables 
(state). 


= Things an object does are its methods (behavior). 


= Methods can use instance variables so that objects 
of the same type can behave differently. 


= Amethod can have parameters, which means you 
can pass one or more values in to the method. 


= The number and type of values you pass in must 
match the order and type of the parameters 
declared by the method. 


= Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 


= The value you pass as an argument to a method 
can be a literal value (2, ‘c’, etc.) or a variable of 
the declared parameter type (for example, x where 
x is an int variable). (There are other things you 
can pass as arguments, but we're not there yet.) 


= Amethod must declare a return type. A void return 
type means the method doesn’t return anything. 


= |famethod declares a non-void return type, it must 
return a value compatible with the declared return 


type. 


Cool things you can do with parameters 


and return types 


Now that we’ve seen how parameters and return types work, it’s time 
to put them to good use: let’s create Getters and Setters. If you’re 
into being all formal about it, you might prefer to call them Accessors 
and Mutators. But that’s a waste of perfectly good syllables. Besides, 
Getters and Setters fits a common Java naming convention, so that’s 
what we'll call them. 


Getters and Setters let you, well, get and set things. Instance variable val- 
ues, usually, A Getter’s sole purpose in life is to send back, as a return 
value, the value of whatever it is that particular Getter is supposed to 
be Getting, And by now, it’s probably no surprise that a Setter lives and 
breathes for the chance to take an argument value and use it to set the 
value of an instance variable. 


class ElectricGuitar { 
String brand; 
int numOfPickups ; 
boolean rockStarUsesIt; 


String getBrand() { 
return brand; 


} 


void setBrand(String aBrand) { 
brand = aBrand; 
} 


int getNumOfPickups() { 
return numOfPickups ; 


} 


void setNumOfPickups(int num) { 
numOfPickups = num; 


} 


boolean getRockStarUsesIt() { 
return rockStarUsesIt; 


} 


void setRockStarUsesIt (boolean yesOrNo) { 
rockStarUsesIt = yesOrNo; 
} 
} 


methods use instance variables 


ElectricGuitar 


brand 
numOfPickups 
rockStarUseslt 


Note: Using, 
hese narmind, 


getBrand() conventions means 
setBrand() youve following | 
y standard tha 
getNumOfPickups() ovll see an 
e€ 
setNumOfPickups() ox Java 
getRockStarUseslt() 


setRockStarUseslt() 
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real developers encapsulate 


Encapsulation 


Do it or risk humiliation and 
ridicule. 


Until this most important moment, we’ve 
been committing one of the worst OO faux 
pas (and we’re not talking minor violation 
like showing up without the “B” in BYOB). 
No, we’re talking Faux Pas with a capital 


oR ” And “p ” 
Our shameful transgression? 
Exposing our data! 


Here we are, just humming along without a 
care in the world leaving our data out there 
for anyone to see and even touch. 


You may have already experienced that 
vaguely unsettling feeling that comes with 
leaving your instance variables exposed. 


Exposed means reachable with the dot opera- 
tor, as in: 


theCat.height = 27; 


Think about this idea of using our remote 
control to make a direct change to the Cat 
object’s size instance variable. In the hands of 
the wrong person, a reference variable (remote 
control) is quite a dangerous weapon. Because 
what’s to prevent: 


Oh wy 9008 cen 
theCat height = 0; (niet this harren 


This would be a Bad Thing. We need to build 
setter methods for all the instance variables, 
and find a way to force other code to call the 
setters rather than access the data directly. 
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Jen says you're 
well-encapsulated... 


body 


i to eall a setter 
ares ne ior protect the eat *rom 
me ) 


unaceeptable size changes: 


public void setHeight(int ht) { 
if (ht > 9) { < 
. We Put ine 
height = ht; Iarantee 5 
In— 
} mum eat. height. 


heeks to 


Hide the data 


Yes, it zs that simple to go from 
an implementation that’s just 
begging for bad data to one that 
protects your data and protects 
your right to modify your 
implementation later. 


OK, so how exactly do you hide 
the data? With the public 
and private access modifiers. 
You’re familiar with public— 
we use it with every main 
method. 


Here’s an encapsulation starter 
rule of thumb (all standard 
disclaimers about rules of 
thumb are in effect): mark your 
instance variables private and 
provide public getters and 
setters for access control. When 
you have more design and cod- 
ing savvy in Java, you will prob- 
ably do things a little differently, 
but for now, this approach will 
keep you safe. 


Mark instance 
variables private. 


Mark getters and 
setters public. 


“Sadly, Bill forgot to 
encapsulate his Cat class and 
ended up with a flat cat.” 


(overheard at the water cooler) 


methods use instance variables 


Java Exposed 


This week’s interview: 
An Object gets candid about encapsulation. 


HeadFirst: What’s the big deal about encapsulation? 


Object: OK, you know that dream where you're giving a talk to 500 people when you 
suddenly realize you’re naked? 


HeadFirst: Yeah, we've had that one. It’s right up there with the one about the Pilates 
machine and...no, we won't go there. OK, so you feel naked. But other than beimg a little 
exposed, is there any danger? 


Object: Is there any danger? Is there any danger? [starts laughing] Hey, did all you other 
imstances hear that, “Ls there any danger?” he asks? [falls on the floor laughing] 


HeadFirst: What’s funny about that? Seems like a reasonable question. 

Object: OK, I'll explain it. It’s [bursts out laughing again, uncontrollably] 
HeadFirst: Can I get you anything? Water? 

Object: Whew! Oh boy, No I’m fine, really. I’ll be serious. Deep breath. OK, go on. 
HeadFirst: So what does encapsulation protect you from? 


Object: Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let’s say, something znappropriate. 


HeadFirst: Can you give me an example? 


Object: Happy to. Most instance variable values are coded with certain assumptions 
about their boundaries. Like, think of all the things that would break if negative numbers 
were allowed. Number of bathrooms in an office. Velocity of an airplane. Birthdays. 
Barbell weight. Phone numbers. Microwave oven power. 


HeadFirst: I see what you mean. So how does encapsulation let you set boundaries? 


Object: By forcing other code to go through setter methods. That way, the setter method 
can validate the parameter and decide if it’s doable. Maybe the method will reject it and 
do nothing, or maybe it'll throw an Exception (like if it’s a null Social Security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method, whereas you can’t do anything if your instance variables are public. 


HeadFirst: But sometimes I sce setter methods that simply set the value without check- 
ing anything. If you have an instance variable that doesn’t have a boundary, doesn’t that 
setter method create unnecessary overhead? A performance hit? 


Object: The point to setters (and getters, too) is that_you can change your mind later, 
without breaking anybody else’s code! Imagine if half the people in your com- 

pany used your class with public instance variables, and one day you suddenly realized, 
“Oops—there’s something I didn’t plan for with that value, I’m goimg to have to switch 

to a setter method.” You break everyone’s code. The cool thing about encapsulation is 
that you get to change your mind. And nobody gets hurt. ‘The performance gain from using 
variables directly is so miniscule and would rarely—if ever—be worth it. 
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how objects behave 


Encapsulating the 
GoodDog 
GoodDog class 2s uaa 
«chante private int size; size 
Nye > 
Tats “ 
varie public int getSize() { etSize( ) 
return size; a ; 
} setSize( ) 
bark( ) 


rn 
ve the getter ali — > public void setSize(int s) { 
Make ekhods we 


serter ™ 


: i 
Lhouah the methods don t veally 
Coen ne Pavetionality the nice thing 


ind later. 
is that you can Change your min 
is aes back and make a method 


safer, faster, better. 


Any place where a 
particular value can 
be used, a method 
call that returns that 
type can be used. 


instead of: 
int x = 3+ 24; 


you can say: 


int x = 3 + one.getSize(); 
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size = s; 


} 


void bark() { 
if (size > 60) { 
System.out.println("Wooof! Wooof!"); 
} else if (size > 14) { 
System.out.println("Ruff! Ruff!"); 
} else { 
System.out.printin("Yip! Yip!"); 


class GoodDogTestDrive { 


public static void main(String[] args) { 


GoodDog one = new GoodDog() ; 
one.setSize(70); 
GoodDog two = new GoodDog() ; 


two.setSize(8); 


System.out.printin("Dog one: " + one.getSize()); 
System.out.printin("Dog two: " + two.getSize()); 
one.bark(); 
two.bark(); 


methods use instance variables 


How do objects in an array 
behave? 


Just like any other object. The only difference is how you 
get to them. In other words, how you get the remote con- 
trol. Let’s try calling methods on Dog objects in an array. 


Declare and create a Dog array 
to hold seven Dog references. 


Dog[] pets; 


new Dog[7] Po 


pets = 


Create two new Dog objects, 
and assign them to the first 
two array elements. 
pets[0] = new Dog(); 
pets[1] = new Dog(); 


3) Call methods on the two Dog 
objects. 
pets [0] .setSize (30) ; 
int x = pets[0].getSize() ; 
pets[1] .setSize (8) ; 


(oe 
Dog Dog Dog Dog Dog Dog 


Dog array object (Dog[]) 
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initializing instance variables 


Declaring and initializing 
instance variables 


. . Instance variables 
You already know that a variable declaration needs at least a name and 
acne always get a 


int size; default value. If 
leas cael you don’t explicitly 
And you know that you can initialize (assign a value to) the variable at a ssign a value 
the same time: . 
we to an instance 
int size = 420; O 
String name = "Donny"; variable or you 
don’t call a setter 


But when you don’t initialize an instance variable, what happens when 
you call a getter method? In other words, what is the value of an instance 


method, the 


variable before you initialize it? instance variable 
jables) . 
Derlare ‘ovo instante still has a value! 
class PoorDog { don t assign d 
private int size; a eos integers 0 


private String name; 


ic i Feeneerecas |octing points 0.0 
public int getSize() { {— 
return size; 


} 


booleans false 


references null 


public String getName() { 
return name; 


} 
} 
: : nik will 
public class PoorDogTestDrive { b do YO “2 
public static void main(String[] args) { Wha even coregne: 
PoorDog one = new PoorDog() ; nis 
System.out.println("Dog size is " + one.getSize()); 
System.out.println("Dog name is " + one.getName() ) ; 
bl 
} _cLealiog instante variables, 
—————— You don t have to initialize cant value. Number 
because they always ake t b. cocleans get 
z ; e' 4 ‘ e ) 
% java PoorDogTestDrive rimitives Cindluding Char” BE Tes get null 


‘gise, and object rexerent 


Dog size is 0 


(R ber, null just means 3 remote tontral that 
emem ? 


thing. A 
aa eee aan isnt tontrolling, / progranmed, ‘2 avy nd 
reference, but no ae ual o| yee ; 
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The difference between instance 
and local variables 


Instance variables are declared 
inside a class but not within a method. 


class Horse { 
private double height = 15.2; 
private String breed; 
// more code... 


2) Local variables are declared within a method. 


class AddThing { a 
int a; y INSTANCE variables 
int i-= 1.2: 

public int add() { 

<< LOCAL vari 
int total = a +b; AL variable 


return total; 


} 


Local variables MUST be initialized before use! 
So eee 


class Foo { 


Won't compilel! You can 


putas A Gok 
declare * ‘without a value, 


int x; 


tr 
meren soy Cheer ioe 
} Se Leaks out- 


| File Edit_Window Help Yikes 
% javac Foo.java 


Foo.java:4: variable x might 
not have been initialized 


Shiga 12 S $2 ap Sig 
1 error as 


methods use instance variables 


Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before 

the variable is 
initialized. 


there, are_no 


Dumb Questions 


Q: What about method parameters? 
How do the rules about local variables 
apply to them? 


A: Method parameters are virtually the 
same as local variables—they’re declared 
inside the method (well, technically they're 
declared in the argument list of the method 
rather than within the body of the method, 
but they’re still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you'll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 


Instead, the compiler will give you an error 
if you try to invoke a method without giving 
the arguments that the method needs. So 
parameters are always initialized, because 
the compiler guarantees that methods are 
always called with arguments that match 
the parameters. The arguments are assigned 
(automatically) to the parameters. 
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object equality 


Comparing variables (primitives or references) 


Sometimes you want to know if two primitives are the same; for example, 


you might want to check an int result with some expected integer value. Use - to comp are two 
That’s easy enough: just use the == operator. Sometimes you want to know primitives of to see f 


if two reference variables refer to a single object on the heap; for example, 

is this Dog object exactly the same Dog object I started with? Easy as well: two references refer to 
just use the == operator. But sometimes you want to know if two objects are : 

equal. And for that, you need the .equals() method. the same object. 


The idea of equality for objects depends on the type of object. For Use the equals() method 
example, if two different String objects have the same characters (say, “my to See f two different 


name”), they are meaningfully equivalent, regardless of whether they are i 

two distinct objects on the heap. But what about a Dog? Do you want to objects are equal. 
treat two Dogs as being equal if they happen to have the same size and 

weight? Probably not. So whether two different objects should be treated (Eg, two different String objects that 
as equal depends on what makes sense for that particular object type. We'll both contain the characters “Fred”) 
explore the notion of object equality again in later chapters, but for now, 

we need to understand that the == operator is used only to compare the bits in two variables. 

What those bits represent doesn’t matter. The bits are either the same, or they’re not. 


To compare two primitives, use the == operator 
—— 


me == operator can be used to compare two variables of any kind, and it simply compares ie * Pattern, Se 
¢, 
the bits. are equal 4, ese two 
if (a == b) {...} looks at the bits in a and b and returns true if the bit pattern is the same 
(although all the extra zeros on the left end don’t matter). e zeros oO” 
: e are ™ wh 
ceed: “Whe left side of sak 
byte b = 3; vt we gon & tae 
hat ere) 
if (a == b) { // true } 


To see if two references are the same (which means they refer to 
the same object on the heap) use the == operator The bj 


Sdme a Patterns are th 
Remember, the == operator cares only about the pattern of bits in the variable. The rules are eaual a an o th e 
are the same whether the variable is a reference or primitive. So the == operator returns “sing == 2 
true if two reference variables refer to the same object! In that case, we don’t know what the 
bit pattern is (because it’s dependent on the JVM and hidden from us), but we do know that ©) 


whatever it looks like, zt well be the same for two references to a single object. 


Foo a =new Foo(); 


Foo b = new Foo(); \") a) 

Foo c = a; E56 Hl er 
if (a ==b) { } // false a == ¢ is true ; 

if (a == c) { } // true a == bis false Fos 

if (b == c) { } // false oe 
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methods use instance variables 


BULLET POINTS 


= Encapsulation gives you control over who changes the 
data in your class and how. 


= Make an instance variable private so it can’t be changed 


- a oles by accessing the variable directly. 
private. If you want to = Create a public mutator method, e.g., a setter, to control 
see them, you have to how other code interacts with your data. For example, 
talk to my methods. you can add validation code inside a setter to make sure 


the value isn’t changed to something invalid. 


= Instance variables are assigned values by default, even 
if you don’t set them explicitly. 


= Local variables, e.g., variables inside methods, are 
not assigned a value by default. You always need to 
initialize them. 


= Use == to check if two primitives are the same value. 


= Use == to check if two references are the same, i.e., two 
object variables are actually the same object. 


= Use .equals() to see if two objects are equivalent (but 
not necessarily the same object), e.g., to check if two 
String values contain the same characters. 


G harpen your pencil 
ING int a = calcArea(7, 12); 
short c = 7; 


t 

What’s legal? K F F P calcArea(c, 15); 
Given the method below, which of 
the method calls listed on the right @ = int d = calcArea (57) ; 
are legal? 
Put a checkmark next to the ones R | G H T calcArea(2, 3); 
that are legal. (Some statements are 
there to assign values used in the long t = 42; 


method calls.) int £ = calcArea(t, 17); 


int g = calcArea() ; 


int calcArea(int height, int width) { 


calcArea () ; 


return height * width; 


byte h = calcArea(4, 20); 


int j = calcArea(2, 3, 5); 
> Answers on page 93. 
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exercise: Be the Compiler 


BE the Compiler 


Each of the Java files on this page 

. Fepresents a complete source file. 

,. Your job is to play compiler and 

, determine whether each of these files 
) will compile. If they won't 
compile, how would you 
fix them, and if they do 
compile, what would be 
their output? 


class XCopy { class Clock { 
String time; 
public static void main(String[] args) { 


int orig = 42; void setTime (String t) { 
XCopy x = new XCopy(); time = t; 
int y = x.go(orig); } 
System.out.println(orig + " "+ y); 

} void getTime() { 

return time; 

int go(int arg) { } 
arg = arg * 2; } 
return arg; 

} class ClockTestDrive { 

} public static void main(String[] args) { 


Clock c = new Clock(); 
c.setTime ("1245"); 
String tod = c.getTime(); 
System.out.println("time: "+tod) ; 
————> Answers on page 93. 
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methods use instance variables 


A bunch of Java components, in full costume, are playing a party 
game, “Who am |?” They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be 
true for more than one attendee, then write down all for whom that 
sentence applies. Fill in the blanks next to the sentence with the 
names of one or more attendees. 


9 Tonight's attendees: 
wn 3 Py instance variable, argument, return, getter, setter, 
: encapsulation, public, private, pass by value, method 


A class can have any number of these. 
A method can have only one of these. 
This can be implicitly promoted. 

| prefer my instance variables private. 
It really means “make a copy.” 

Only setters should update these. 

A method can have many of these. 

| return something by definition. 

| shouldn’t be used with instance variables. 
| can have many arguments. 

By definition, | take one argument. 
These help create encapsulation. 


| always fly solo. 


——— Answers on page 93. 
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puzzle: Mixed Messages 


Mixed 
Messages 


A short Java program is listed to your right. 
Two blocks of the program are missing. 
Your challenge is to match the candidate 
blocks of code (below) with the output 
that you'd see if the blocks were inserted. 


Not all the lines of output will be used, and 
some of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 


Candidates: 


i < 9g 14 7 
index < 5 9 5 
i < 20 19 i 
index < 5 14.1 
i < 7 Za) AL 
index < 7 a 
i <9 aud. 
index < 1 AQ 
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Possible output: 


public class Mix4 { 


int counter = 0; 


public static void main(String[] args) { 
int count = 0; 
Mix4[] mixes = new M1ix4[20]; 
int 1 = 0; 
while ( [ ) { 
mixes[i] = new Mix4(); 


mixes[i].counter = mixes[i].counter + 1; 


count count + 1; 
count = count + mixes[i].maybeNew (i) ; 
i=it+l; 

} 


System.out.printin(count + " " + 


mixes[1].counter) ; 


public int maybeNew(int index) { 
Mix4 mix = new Mix4(); 
mix.counter = mix.counter + 1; 
return 1; 
} 


return 0; 


————> Answers on page 94. 
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public class Puzzle4 { 


int number = 1; 


Poo] Puzzle i ke, 


while (i < 6) { 


\ Your job is to take code snippets from the 
} V3 pool and place them into the blank lines 
Vig in the code. You may not use the same 

snippet more than once, and you won't 
need to use all the snippets. Your goal 

is to make a class that will compile and } 
run and produce the output listed. 


number = number * 10; 


int result = 0; 
i = 6; 


> Answers on page 94. while (i > 0) { 


result = result + 


public static void main(String [] args) 


} 
Output 


} 
Sjava Puzzle4 } 


result 543345 


class { 
int intValue; 
doStuff (int 
if (intValue > 100) { 
return 
} else { 
return 


Note: Each snippet 
from the pool can be 
used only once! 


values.doStuff(i); 
values[i].doStuff(factor); 


intValue=i; — yalues|i].doStuff(i); 
values.intValue = i; intValue + factor; Puzzle4 
H * . 
values[i].intValue = i; «-aialiia intValue * (2 + factor); " int 
i * . 
values[i].intValue = number; ne intValue * (5 - factor); Value( ) snort 
actor — intValue * factor; fee Wet? 
uzzle4 [] values = new Puzzle4[6]; public values [i] = new Value(i); 
_ Value [] values = new Value[6]; private ak Vallee [ete vellet): 
A value [] values = new Puzzle4[6]; loge: values [i] = new Value( ); 


values = new Value( ); 
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System.out.printin("result " + result); 
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puzzle: Five Minute Mystery 
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chapter 4 


Fast Times in Stim-City 


When Buchanan roughly grabbed Jai’s arm from behind, Jai froze. Jai knew that Buchanan was 
as stupid as he was ugly and he didn’t want to spook the big guy. Buchanan ordered Jai into his 
boss’s office, but Jai’d done nothing wrong (lately), so he figured a little chat with Buchanan’s 
boss Leveler couldn’t be too bad. He’d been moving lots of neural-stimmers in the west side 
lately, and he figured Leveler would be pleased. Black market stimmers weren’t the best money 
pump around, but they were pretty harmless. Most of the stim-junkies he’d seen tapped out after 
a while and got back to life, maybe just a little less focused than before. 


Leveler’s “office” was a skungy-looking skimmer, but once Buchanan shoved him in, Jai could 
see that it’d been modified to provide all the extra speed and armor that a local boss like Leveler 
could hope for. “Jai my boy,” hissed Leveler, “pleasure to see you again.” “Likewise I’m sure...,” 
said Jai, sensing the malice behind Leveler’s greeting, “We should be square Leveler, have I 
missed something?” “Ha! You’re making it look pretty good, Jai. Your volume is up, but I’ve 
been experiencing, shall we say, a little ‘breach’ lately,” said Leveler. 


Jai winced involuntarily; he’d been a top drawer jack-hacker in his day. Anytime someone fig- 
ured out how to break a street-jack’s security, unwanted attention turned toward Jai. “No way it’s 
me man,” said Jai, “not worth the downside. I’m retired from hacking, I just move my stuff and 

mind my own business.” “Yeah, yeah,” laughed Leveler, “I’m sure you’re clean on this 
one, but I’ll be losing big margins until this new jack-hacker is shut out!” “Well, best 
of luck, Leveler. Maybe you could just drop me here and I’ll go move a few more 

‘units’ for you before I wrap up today,” said Jai. 


“I’m afraid it’s not that easy, Jai. Buchanan here tells me that word is you’re cur- 
rent on Java NE 37.3.2,” insinuated Leveler. “Neural edition? Sure, I play around a 
bit, so what?” Jai responded, feeling a little queasy. “Neural edition’s how I let the stim- 
junkies know where the next drop will be,” explained Leveler. “Trouble is, some stim-junkie’s 
stayed straight long enough to figure out how to hack into my Warehousing database.” “I need a 
quick thinker like yourself, Jai, to take a look at my StimDrop Java NE class; methods, instance 
variables, the whole enchilada, and figure out how they’re getting in. It should...,” “HEY!” 
exclaimed Buchanan, “I don’t want no scum hacker like Jai nosin’ around my code!” “Easy big 
guy,” Jai saw his chance, “I’m sure you did a top rate job with your access modi...” “Don’t tell 
me, bit twiddler!”’ shouted Buchanan, “I left all of those junkie-level methods public so they 
could access the drop site data, but I marked all the critical WareHousing methods private. No- 
body on the outside can access those methods, buddy, nobody!” 


“T think I can spot your leak, Leveler. What say we drop Buchanan here off at the corner and 
take a cruise around the block?” suggested Jai. Buchanan clenched his fists and started toward 
Jai, but Leveler’s stunner was already on Buchanan’s neck, “Let it go, Buchanan,” sneered Lev- 
eler, “Keep your hands where I can see them and step outside. I think Jai and I have some plans 
to make.” 

What did Jai suspect? 


Will he get out of Leveler’s skimmer with all his bones intact? 


—————— Answers on page 94. 


Exercise Solutions 


Sharpen your pencil (from page 87) 
int a = calcArea(7, 
short c = 7; 
calcArea(c, 


12); 


int d = calcArea (57); 


calcArea(2, 3); Se 


long t = 42; 


15); 


int £ = calcArea(t, 17); 
int g = calcArea(); 
calcArea (); 

byte h = calcArea(4, 20); 
int j = calcArea(2, 3, 5); 


A class can have any number of these. 
A method can have only one of these. 
This can be implicitly promoted. 

| prefer my instance variables private. 
It really means “make a copy.” 

Only setters should update these. 

A method can have many of these. 


| return something by definition. 


BE the Compiler (from page 88) 


| shouldn’t be used with instance variables 


| can have many arguments. 


Who Am I 2 (from page 89) 


By definition, | take one argument. 
These help create encapsulation. 


| always fly solo. 


methods use instance variables 


Class ‘XCopy’ compiles and runs as it stands! The 
output is: ‘42 84’. Remember, Java is pass by value, 
(which means pass by copy), and the variable ‘orig’ is 
not changed by the go( ) method. 


class Clock { 
String time; 


void setTime (String t) { 
time = t; 


} 


String getTime() { 
return time; 


Note: 


return 


ave a 
} 


} 


h 
4 +t, methods 
eet definition 


class ClockTestDrive { 
public static void main(String[] args) { 
Clock c = new Clock(); 
c.setTime ("1245"); 
String tod = c.getTime(); 
System.out.println("time: " + tod); 


} 


instance variables, getter, setter, method 


return 


return, 


argument 


encapsulation 


pass by value 


instance variables 


argument 


getter 
public 
method 
setter 
getter, 


return 


setter, public, private 
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puzzle solutions 


Puzzle Solutions 


Poo] Puzzle (from page 91) 


Five-Minute Mystery (from page 92) 


What did Jai suspect? 


public class Puzzle4 { 
public static void main(String[] args) { 


Value[] values = new Value[6]; Jai knew that Buchanan wasn’t the sharpest 

int number = 1; pencil in the box. When Jai heard Buchanan 

a“ : of Oe talk about his code, Buchanan never mentioned 

while (i < 6) { a . ‘ i 
values{i] = new Valuel); his instance variables. Jai suspected that while 
values[i].intValue = number; Buchanan did in fact handle his methods 
number = number * 10; correctly, he failed to mark his instance variables 
hed private. That slip-up could have easily cost 

Leveler thousands. 


int result = 0; 
i = 6; 
while (i > 0) { 
i=i-1; 
result = result + values[i].doStuff(i); 


} Mixed 
System.out.printin("result " + result); Messages (from page 90) 
} 
Candidates: Possible output: 
class Value { 
int intValue; i < 9 Leal 
publicint doStuff(int factor) { index < 5 
if (intValue > 100) { 2D 
return intValue* factor; 
} else { : 
return intValue * (5 - factor); a wel 
} ; 
iLinilese << 5 14.1 
} 
Output eel 
oo : 
S$java Puzzle4 
°J index < 7 vw) 


94 


result 543345 


index < 1 AO) & 
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5 writing a program 


Extra-Strength Methods 


T can lift 
heavy objects. 


Let’s put some muscle in our methods. we dabbled with variables, played 
with a few objects, and wrote a little code. But we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little more interesting than, 
say, bark. And loops. We need loops, but what's with the wimpy while loops? We need for 
loops if we're really serious. Might be useful to generate random numbers. Better learn 
that too. And why don't we learn it all by building something real, to see what it’s like to write 
(and test) a program from scratch. Maybe a game, like Battleships. That's a heavy-lifting task, 
so it'll take two chapters to finish. We'll build a simple version in this chapter and then build a 


more powerful deluxe version in Chapter 6, Using the Java Library. 


this is a new chapter 95 


building a real game 


Let’s build a Battleship-style 
game: “Sink a Startup” 


It’s you against the computer, but unlike the real Battleship 
game, in this one you don’t place any ships of your own. 
Instead, your job is to sink the computer’s ships in the fewest 
number of guesses. 


Oh, and we aren’t sinking ships. We’re killing ill-advised, 
Silicon Valley Startups (thus establishing business relevancy 
so you can expense the cost of this book). 


Goal: Sink all of the computer’s Startups in the fewest 
number of guesses. You’re given a rating or level, based on 
how well you perform. 


Setup: When the game program is launched, the computer 
places three Startups on a virtual 7 x 7 grid. When that’s 
complete, the game asks for your first guess. 


How you play: We haven’t learned to build a GUI yet, 

so this version works at the command line. The computer 
will prompt you to enter a guess (a cell) that you'll type at 
the command line as “A3,” “C5,” etc.). In response to your 
guess, you'll see a result at the command-line, either “hit,” 
“miss,” or “You sunk poniez” (or whatever the lucky Startup 
of the day is). When you’ve sent all three Startups to that big 
404 in the sky, the game ends by printing out your rating, 


AG starts at zero, like Java arrays 
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You’re going to build the 
Sink a Startup game, with 
a 7x7 grid and three 
Startups. Each Startup 
takes up three cells. 


part of a game interaction 


File Edit Window Help Sell 


Sjava StartupBust 
Enter a guess A3 
miss 

Enter a guess B2 
miss 

Enter guess 
miss 

Enter guess 

hit 

Enter a guess D3 
hit 

Enter a guess D4 
Ouch! You sunk poniez 
kill 

Enter a guess G3 
hit 

Enter a guess 

hit 

Enter a guess G5 


Ouch! You sunk hacqi = a i( 


All Startups are dead! Your stock 
is now worthless 


Took you long enough. 62 guesses. 


First, a high-level design 


We know we'll need classes and methods, but what 
should they be? To answer that, we need more infor- 
mation about what the game should do. 


First, we need to figure out the general flow of the 
game. Here’s the basic idea: 


& User starts the game. 


A) Game creates three Startups 


Game places the three Start- 
ups onto a virtual grid 


Game play begins. 


Repeat the following until there are 
no more Startups: 


Prompt user for a guess 
(“A2," "CO," etc.) 


Check the user guess against 
all Startups to look for a hit, 
miss, or kill. Take appropri- 
ate action: if a hit, delete cell 
(A2, D4, etc.). If a kill, delete 
Startup. 


Game finishes. 


Give the user a rating based on 
the number of guesses. 


Now we have an idea of the kinds of things the 
program needs to do. The next step is figuring out 
what kind of objects we'll need to do the work. 
Remember, think like Brad rather than Laura (who 
we met in Chapter 2,.A Trip to Objectville); focus 

first on the things in the program rather than the 
procedures. 


writing a program 


wvele means 
h ew Ciieh 


start or 


\e 1s 
heer erect 


ra an gtkion 


Game setup Q ‘B) 


Get user 


guess (A) 
A remove 
guess location cell 


A diamond 


eu represents a 
remove detision point. 
Startup 


still some 
Startups 
alive? 


no 
display user 
score/rating 


Whoa. A real flow chart. 
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a simpler version of the game 


The “Simple Startup Game” 
a gentler introduction 


It looks like we’re gonna need at least two classes, a Game 
class and a Startup class. But before we build the full- 
monty Sink a Startup game, we'll start with a stripped- 
down, simplified version, Simple Startup Game. We'll 
build the simple version in ¢his chapter, followed by the 
deluxe version that we build in the next chapter. 


Everything is simpler in this game. Instead of a 2-D grid, 
we hide the Startup in just a single row. And instead of three 
Startups, we use one. 


The goal is the same, though, so the game still needs to 
make a Startup instance, assign it a location somewhere in 
the row, get user input, and when all of the Startup’s cells 
have been hit, the game is over. This simplified version 

of the game gives us a big head start on building the full 
game. If we can get this small 
SimpleStartupGame 


one working, we can scale it up 
to the more complex one later. 


In this simple version, the game SimpleStartup 


class has no instance variables, 


int [] locationCells 


and all the game code is in the int numO#Hits 


main() method. In other words, 
when the program is launched 
and main() begins to run, it will 
make the one and only Startup 
instance, pick a location for it 
(three consecutive cells on the 
single virtual seven-cell row), ask 
the user for a guess, check the 
guess, and repeat until all three cells have 
been hit. 


Keep in mind that the virtual row is...vertual. In other 
words, it doesn’t exist anywhere in the program. As long 
as both the game and the user know that the Startup 

is hidden in three consecutive cells out of a possible 
seven (starting at zero), the row itself doesn’t have to be 
represented in code. You might be tempted to build an 
array of seven ints and then assign the Startup to three 
of the seven elements in the array, but you don’t need to. 
All we need is an array that holds just the three cells the 
Startup occupies. 
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String checkYourself(int guess) 


void setLocationCells(int] loc) 


Game starts and creates ONE Startup 
and gives it a location on three cells in 
the single row of seven cells. 


Instead of “A2," "C4," and so on, the 
locations are just integers (for example: 
1,2,3 are the cell locations in this 
picture): 


3) Game play begins. Prompt user for 


a guess; then check to see if it hit 
any of the Startup’s three cells. 
If a hit, increment the numOfHits 
variable. 


© Game finishes when all three cells have 


been hit (the numOfHits variable val- 
ue is 3), and the user is told how many 
guesses it took to sink the Startup. 


A complete game interaction 
| File Edit Window Help Destroy 
Sjava SimpleStartupGame 
enter a number 2 
hit 
enter a number 3 
hit 
enter a number 4 
miss 
enter a number 1 
kill 


You took 4 guesses 


Developing a Class 


As a programmer, you probably have a methodology/ 
process/approach to writing code. Well, so do we. Our 
sequence 1s designed to help you see (and learn) what we’re 
thinking as we work through coding a class. It isn’t necessarily 
the way we (or you) write code in the Real World. In the Real 
World, of course, you'll follow the approach your personal 
preferences, project, or employer dictate. We, however, can 
do pretty much whatever we want. And when we create a 
Java class as a “learning experience,” we usually do it like 
this: 


O Figure out what the class is supposed to do. 


O 


List the instance variables and methods. 


O Write prep code for the methods. (You'll see 
this in just a moment.) 


Write test code for the methods. 
Implement the class. 
Test the methods. 


Debug and reimplement as needed. 


OO aoa 0 


Express gratitude that we don't have to test 
our so-called learning experience app on 
actual live users. 


writing a program 


The three things we'll write for 
each class: 


prep code test code 


This bar is displayed on the next set of pages to tell 
you which part you’re working on. For example, if 
you see this picture at the top of a page, it means 
you're working on prep code for the SimpleStartup 
class. 


SimpleStartup class 


prep code e code 


prep code 


A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 


test code 
A class or methods that will test the real code 
and validate that it's doing the right thing. 


real code 
The actual implementation of the class. This 
is where we write real Java code. 


To Do: 


simpleStartup class 
‘ C1 write prep code 
Sk. WALI O write test code 
‘PQWwWER O write final Java code 
Flex those dendrites. si mpleStartupGame 
How would you decide which class or classes class 


to build first, when you’re writing a program? 
Assuming that all but the tiniest programs 
need more than one class (if you’re following 
good OO principles and not having one class 
do many different jobs), where do you start? 


11 write prep code 
iE] write test code {not needed] 


O write fina 


| Java code 
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SimpleStartup class 


prep code Fe code 


SimpleStartup 


int [] locationCells 


int numOfHits 


String checkYourself(int guess) 


void setLocationCells(int{] loc) 
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You'll get the idea of how prep code (our version of pseudocode) works as you read 
through this example. It’s sort of halfway between real Java code and a plain English 
description of the class. Most prep code includes three parts: instance variable 
declarations, method declarations, method logic. The most important part of prep code 
is the method logic, because it defines what has to happen, which we later translate into 
how when we actually write the method code. 


DECLARE an int array to hold the location cells. Call it locationCells. 
DECLARE an int to hold the number of hits. Call it numOfHits and SET it to 0. 


DECLARE a checkYourself() method that takes a int for the user's guess (1, 3, etc.), checks it, 
and returns a result representing a ‘hit,’ “miss,” or “kill.” 


DECLARE a setLocationCells() setter method that takes an int array (which has the three cell 
locations as ints (2, 3, 4, etc.)). 


METHOD : String check Yourself(int userGuess) 

GET the user guess as an int parameter 
-— REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 
7 IF the user guess matches 

INCREMENT the number of hits 

// FIND OUT if it was the last location cell: 
-——IF number of hits is 3, RETURN “kill” as the result 


ELSE it was nota kill, so RETURN “hit” 
—END IF 
ELSE the user guess did not match,so RETURN “miss” 
—END IF 
— END REPEAT 


END METHOD 


METHOD: void setLocationCells(int[] cellLocations) 
GET the cell locations as an int array parameter 


ASSIGN the cell locations parameter to the cell locations instance variable 


END METHOD 


prep code testcode (Ms-Eli-Cfl- 


Writing the method 
implementations 


Let’s write the real 
method code now and get 
this puppy working. 


Before we start coding the 
methods, though, let’s back 

up and write some code to 

test the methods. That’s right, 
we're writing the test code before 
there’s anything to test! 


The concept of writing the test 
code first 1s one of the practices 
of Test-Driven Development 
(TDD), and it can make it easier 
(and faster) for you to write 

your code. We’re not necessarily 
saying you should use TDD, but 
we do like the part about writing 
tests first. And TDD just sounds 
cool. 


writing a program 


Oh my! For a minute 
there I thought you 
weren't gonna write your 
test code first. Whoo! 

Don't scare me like that. 


Test-Driven Development (TDD) 


Back in 1999, Extreme Programming (XP) was a newcomer 
to the software development methodology world. One 

of the central ideas in XP was to write test code before 
writing the actual code. Since then, the idea of writing 
test code first has spun off of XP and become the core of a 
newer, more popular subset of XP called TDD. (Yes, yes, we 
know we've just grossly oversimplified this, please cut us a 
little slack here.) 


TDD is a LARGE topic, and we're only going to scratch the 
surface in this book. But we hope that the way we're going 
about developing the “Sink a Startup” game gives you 
some sense of TDD. 


Check out Test Driven Development: By Example by Kent 
Beck if you want to learn more about how TDD works. 


Here is a partial list of key ideas in TDD: 


Write the test code first. 
Develop in iteration cycles. 
Keep it (the code) simple. 


Refactor (improve the code) whenever and 
wherever you notice the opportunity. 


Don't release anything until it passes all the tests. 


Don't put in anything that’s not in the spec 
(no matter how tempted you are to put in 
functionality “for the future”). 


No killer schedules; work regular hours. 
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SimpleStartup class 


prep code testcode Micri(-tl[:) 


Writing test code for the SimpleStartup class 


We need to write test code that can make a SimpleStartup object and 
run its methods. For the SimpleStartup class, we really care about 
only the checkYourself() method, although we wll have to implement the 
setLocationCells() method in order to get the checkYourself() method to run 
correctly. 


Take a good look at the prep code below for the checkYourself() method 
(the setLocationCells() method is a no-brainer setter method, so we’re not 
worried about it, but in a “real” application we might want a more robust 
“setter” method, which we would want to test). 


Then ask yourself, “If the checkYourself() method were implemented, 
what test code could I write that would prove to me the method is 
working correctly?” 


Based on this prep code: Here's what we should test: 
METHOD String check Yourself(int userGuess) 1. Instantiate a SimpleStartup object. 
GET the user guess as an int parameter 2. Assign it a location (an array of 3 ints, like 
REPEAT with each of the location cells in the int array {2, 3, 4}). 
// COMPARE the user guess to the location cell 3. ack) an int to represent a user guess (2, 
eee ee 4. Invoke the checkYourself() method passing 
INCREMENT the number of hits it the fake user guess. 
// FIND OUT if it was the last location cell: 5. Print out the result to see if it’s correct 
IF number of hits is 3, RETURN “Kill” as the result (‘passed” or “failed”). 
ELSE it was nota kill,so RETURN “Hit” 
END IF 
ELSE the user guess did not match,so RETURN “Miss” 
END IF 
END REPEAT 
END METHOD 
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prep code testcode Micrel (-tl[:) 


there, are_no 


Dumb Questions 


: Maybe I’m missing some- 
thing here, but how exactly do 
you run a test on something 
that doesn’t yet exist!? 


A: You don't. We never said 
you start by running the test; 
you start by writing the test. At 
the time you write the test code, 
you won't have anything to run 
it against, so you probably won't 
be able to compile it until you 
write “stub” code that can com- 
pile, but that will always cause 
the test to fail (like, return null). 


Q: Then I still don’t see the 
point. Why not wait until the 
code is written, and then whip 
out the test code? 


A: The act of thinking 
through (and writing) the test 


code helps clarify your thoughts 
about what the method itself 
needs to do. 


As soon as your implementation 
code is done, you already have 
test code just waiting to validate 
it. Besides, you know if you don't 
do it now, you'll never do it. 
There's always something more 
interesting to do. 


Ideally, write a little test code, 
then write only the implementa- 
tion code you need in order to 
pass that test. Then write a little 
more test code and write only 
the new implementation code 
needed to pass that new test. 

At each test iteration, you run 
all the previously written tests 
to prove that your latest code 
additions don’t break previously 
tested code. 


writing a program 


Test code for the SimpleStartup class 


wate 2 
public class SimpleStartupTestDrive { Instanta Lug 
CimpleStar 
public static void main(String[] args) { F err 


SimpleStartup dot new SimpleStartup () 7 


Lor 
; ay 
Make 3" wt a khe 
Lhe \ot ati” onset 
vas siole 1" 
int[] locations = {2, 3, meer a ok of 2 
dot.setLocationCells (locations) ; 
Invoke e 
Se, method ih nes 
e 
tart P. 
Make a Sake 
int userGuess = 2; <— user guess: 
String result = dot.checkYourself(userGuess) ; 
Invoke the Cheek Yoursel£() 


method on the Starty 
hieg and pass it the 


€ Ouess. 


String testResult = "failed"; 
if (result.equals("hit")) { 


testResult = "passed"; 


: ) aves 
£ the fake guess (2) 9 
a 3 “hit”, it’s workin9, 


System.out.printin (testResult) ; x Print 
rin 


ant Out the 
} ( Passed” oy “gear result 


. —_ 

— Sharpen your pencil Yours fo solve. 

IN In the next couple of pages we implement the SimpleStartup class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we not testing in this 
code that we should be testing for? Write your ideas (or lines of 
code) below: 
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SimpleStartup class 


prep code test code 


The checkYourself() method 


There isn’t a perfect mapping from prep code to Java code; you'll see a few adjustments. 
The prep code gave us a much better idea of what the code needs to do, and now we 
have to figure out the Java code that can do the how. 


In the back of your mind, be thinking about parts of this code you might want (or need) 
to improve. The numbers @) are for things (syntax and language features) you haven't 
seen yet. They’re explained on the opposite page. 


GET the user public String checkYourself(int guess) { 


guess Make a variable 
String result = "miss"; —— veturn, put es hold the result we'll 


n ae default 


'€.) We assume g “miss 


REPEAT with 
each cell in the int : i 
fen for (int cell : locationCells) { et with each, ell in th 
9Y leach eel] location a ea ationCells 


IF the user guess 


matches te: Agueen = Certs Compare the user que to e object) 
Clement (cell) ; t Sess to this 
result = "hit"; \ n the array 
INCREMENT 
the number of eee. A <_\We got a hit/ 
hits ® 
break ; <~ Get out of the | 
OOP, n 
to test the other ig meed 
} // end if 

// FIND OUT if i 77 end fox 
rt was the last cell 
lal of hits if (numOfHits == locationCells.length) { 
IS 

; We've ? 
RETURN “kill” result = "kill"; —. i se thie na but let’s see if weve 
as the result result Strin ‘to aia and Change the 
ELSE it was } // end if 9 
not a kill, so 
RETURN'hit” System.out.println(result) ; <_ Display the result fo, the user (“mniss” 
ELSE nless rt was changed to “hit” or “ill 
RETURN return result; «, Return the result back to 
“miss” the ealling method 


} // end method 
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writing a program 


prep code test code 


Just the new stuff 


The things we haven’t seen before are 
on this page. Stop worrying! There are 
more details later in the chapter. This is 
just enough to get you going. 


his for loop declaration as “repeat Th 
sane the ‘locationCells wh rar (:) 
array: take the next element in the areay ek 
and assign it Lo the int variable cell’. 


BY, 
@) The for loop for (int cell : locationCells) { } 
ee 


Detlare a variable th ; ke loo? 
rom the array. iene hold One element over 0 


(a 
Rs through the | ay Wu ae 
ler rs ee ra an int arable aa ate hel ay will be an at ke 
"Lola a ditterent element £ \ c 
array, until there are no more ayaa Si i variable a 
code does a “break”... see #4 below) € ‘ne Kis enayre™ 
4 Wi 


The ++ means add | to 


whatever's there (in other 
@ The post-increment words, intrement by |). 
operator 


numOfHits++ 
numOfHitst++ is the same Gn 


this case) as sayin numOfHits = 
numOLHits + [ es less typing, 


GB) break statement 


break; 


Gets you out of a loop. Immediately. Right here. 
No iteration, no boolean test, just get out now! 
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SimpleStartup class 


prep code iia Final code for SimpleStartup and SimpleStartupTestDrive 
there are ne public class SimpleStartupTestDrive { 
. a public static void main(String[] args) { 
Dumb Questions 


SimpleStartup dot = new SimpleStartup(); 
int[] locations = {2, 3, 4}; 
Q: In the beginning of the dot.setLocationCells (locations) ; 
book, there was an example of a int userGuess = 2; 
for loop that was really different 
from this one—are there two 
different styles of for loops? 


String result dot.checkYourself (userGuess) ; 


String testResult = "failed"; 


if (result.equals("hit")) { 


testResult = "passed"; 
A: Yes! From the first version of } 
Java there has been a single kind System.out.printin(testResult) ; 
of for loop (explained later in this ; 
chapter) that looks like this: ; 
for (int i = 0; i < 10; it+) 
{ 
// do something 10 times class SimpleStartup { 

} private int[] locationCells; 

fHi = 0; 
You can use this format for any peveEe 20 Bee 
kind of loop you need. But... 
since Java 5, you can also use public void setLocationCells(int[] locs) { 
the enhanced for loop (that’s the locationCells = locs; 


official description) when your } 
loop needs to iterate over the 
elements in an array (or another 


kind of collection, as you'll see in public String checkYourself(int guess) { 


the next chapter). You can always String result = "miss"; 
use the plain old for loop to iterate for (int cell : locationCells) { 
over an array, but the enhanced for if (guess == cell) { 
loop makes it easier. Hecate = Bh ets 
numOfHits++; 
* If you can add one to an int break; What should we see when 

by using ++, can you also subtract } // end if we run this code? 
one in some way? } // end for The test code makes a 

i (hnwOrnies <= SimpleStartup object 

and gives it a location at 

A: Yep absolutely. Hopefully it’s facets one! Is.length) { | 23,4. Then it sends a fake 
not too surprising to find out that result = "kill"; user guess of “2” into the 
the syntax is -- (two minuses), like } // end if checkYouself() method. If the 
this: System.out.printin (result) ; | Code is working correctly, we 


should see the result print 
out: 


countdown = i--; return result; 
} // end method 


} // close class % java SimpleStartupTestDrive 
‘ . 5 hit 

There’s a little bug lurking here. It compiles and oe 

runs, but...don’t worry about it for now, but we will P 


have to face it a little later. 
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prep code F code 
eatery your pencil 
NN 


We built the test class and the SimpleStartup class. But we still haven’t made the 
actual game. Given the code on the opposite page and the spec for the actual 
game, write in your ideas for prep code for the game class. We've given you a few 
lines here and there to get you started. The actual game code is on the next page, 
so don’t turn the page until you do this exercise! 


You should have somewhere between 12 and 18 lines (including the ones we wrote, 
but not including lines that have only a curly brace). 


METHOD public static void main (String [] args) 


DECLARE an int variable to hold the number of user guesses, named numOfGuesses 


COMPUTE a random number between 0 and 4 that will be the starting location cell position 


WHILE the Startup is still alive: 


GET user input from the command line 


writing a program 


The SimpleStartupGame 
needs to do this: 


1. Make the single 
SimpleStartup object. 


2. Make a location for it (three 
consecutive cells on a single 
row of seven virtual cells). 


3. Ask the user for a guess. 
4. Check the guess. 


5. Repeat until the Startup is 
sunk. 


6. Tell the user how many 
guesses it took. 


A complete game interaction 
Sjava SimpleStartupGame 
enter a number 2 

hit 

enter a number 3 

hit 

enter a number 4 

miss 

enter a number 1 

kill 

You took 4 guesses 


—> Yours to solve. 
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SimpleStartupGame class 


prep code Fe code 


Prep code for the SimpleStartupGame class 
Everything happens in main() 


There are some things you'll have to take on faith. For example, we have one line of 
prep code that says “GET user input from command line.” Let me tell you, that’s a 
little more than we want to implement from scratch right now. But happily, we’re using 
OO. And that means you get to ask some other class/object to do something for you, 
without worrying about how it does it. When you write prep code, you should assume 
that somehow you'll be able to do whatever you need to do, so you can put all your 
brainpower into working out the logic. 


public static void main (String [] args) 
DECLARE an int variable to hold the number of user guesses, named numOfGuesses, and set it to 0 
MAKE a new SimpleStartup instance 
COMPUTE a random number between 0 and 4 that will be the starting location cell position 


MAKE an int array with 3 ints using the randomly generated number, that number incremented by |, 
and that number incremented by 2 (example: 3,4,5) 


INVOKE the setLocationCells() method on the SimpleStartup instance 


DECLARE a boolean variable representing the state of the game, named isAlive. SET it to true 


WHILE the Startup is still alive (isAlive == true): 
GET user input from the command line 
// CHECK the user guess 
INVOKE the checkYourself() method on the SimpleStartup instance 
INCREMENT numOfGuesses variable 
// CHECK for Startup death 
IF result is “kill” 
SET isAlive to false (which means we won't enter the loop again) 


PRINT the number of user guesses 


END IF 
e,e e 
END WHILE mefacognitive tip 
END METHOD Don't work one part of the brain for too long a stretch at one time. 


Working just the left side of the brain for more than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. 


When you shift to one side, the other side gets to rest and 
recover. Left-brain activities include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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——— BULLET POINTS 


writing a program 


Your Java program should start with a high- 
level design. 


Typically you'll write three things when you 
create a new class: 


= prep code 
« test code 
« real (Java) code 


Prep code should describe what to do, not 
how to do it. Implementation comes later. 


Use the prep code to help design the test 
code. 


Aclass can have one superclass only. 


Write test code before you implement the 
methods. 


Choose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 


The enhanced for loop is an easy way to loop 
over an array or collection. 


Use the increment operator to add 1 toa 
variable (x++;). 


Use the decrement operator to subtract 1 from 
a variable (x--;). 


Use break to leave a loop early (i.e., even if 
the boolean test condition is still true). 


How many 
hits did you get 
last month? 


Including 
repeat visitors? 
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SimpleStartupGame class 


prep code | test code [{(-F\\feveye [= ; : 
ese) The game’s main() method 


Just as you did with the SimpleStartup class, be thinking about parts of this code you 
might want (or need) to improve. The numbered things @ are for stuff we want to point 
out. They’re explained on the opposite page. Oh, if you’re wondering why we skipped 
the test code phase for this class, we don’t need a test class for the game. It has only one 
method, so what would you do in your test code? Make a separate class that would call 


main() on this class? We didn’t bother, we’ll just run this to test it. 


DECLARE a vari- 
able to hold user 
guess count, and set 
it to 0 


MAKE a Simple- 
Startup object 


COMPUTE a 
random number 
between 0 and 4 


MAKE an int array 
with the 3 cell loca- 
tions, and 


INVOKE setLo- 
cationCells on the 
Startup object 


DECLARE a bool- 
ean isAlive 


WHILE the 
Startup is still alive 


GET user input 
// CHECK it 


INVOKE checkYo- 
urself() on Startup 


INCREMENT 
numOfGuesses 


IF result is “kill” 
SET isAlive to false 


PRINT the number 
of user guesses 
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public static void main(String[] args) { 


Make a variable to Gar = 
many guesses be user ™ 


This is a special class we wrote that has 
GameHelper helper = new GameHelper(); the method for getting user input. For 
now, pretend it’s part of Java. 


int numOfGuesses = 0; 


SimpleStartup theStartup = new SimpleStartup() ; Make the Startup object. 


int randomNum = (int) (Math.random() * 5); Make a random number £. 
h 
first cell, and use it to ot ° 
a the ell locations array. 


int[] locations = {randomNum, randomNum + 1, randomNum + 2}; 


; its locations 
theStartup.setLocationCells (locations) ; «— Give the Sail i 
(the array). 


boolean isAlive = true; 


¢—__ Make a boolean variable to track whether the 
game is still alive, to use in the while loop test. 


A repeat while game is still alive. 
while (isAlive) { @ , i. Get user guess 


int guess = helper.getUserInput ("enter a number") ; 


String result = theStartup.checkYourself (guess) ; 


<— Ask the Sta 
. Inerement guess rtup to cheek th 
numOfGuesses++ ; <—— teil by cs e 
if (result.equals("kill")) { 
n_ Was it a “Kill’2 if So, set isAli ; 
isAlive = false; <——___ re-enter the loop) and oo my 


System.out.println("You took " + numOfGuesses + " guesses") ; 
} // close if 


} // close while 


writing a program 


prep code test code 


random() and getUserlnput() 7, is a ‘east’ and it fortes the 4 
y, and it rorces the thing 


Two things that need a bit more ex- hie sri after it to become the 

plaining are on this page. This is just pire or the cast (ie, the type in the The Math-random method oo 

a quick look to keep you going; more ee Math-random returns a turns a number From re J 

details on the GameHelper class are at (we y, Arpt anes : . int Seen yee : anelee 

the end of this chapter Ovand 4). In this case, the yes At Snore Oto % lie, O- TIN 
off the fractional part of the dolic cast to an int). 


Make a random 


number l 


int randomNum = (int) CMath.random() * 5) 


We declare an int variable to hold 7 
the random number we get back. . i comes negra aig of 


Math.random() has been around forever, so you’]] see code 
like this in the Real World. These days you can use 
java.uti].Random's nextInt() method instead, which is more 
convenient (you don’t have to cast the result to an int). 


The Random class is in a different package. Since we 
haven’t covered importing packages yet (it's in the next 
chapter), we've used Math.random() instead. 


od 
IrGument that ee a String 
Si 


the user use: 
at Prompt 
An instance we made earlier disp} ver You oe d line, F 
of a class that we built to be ayed in the demas 1 Sets 
help with the game. It’s called a ore the m ethed i just 
Getting user input — G3mettelper and you haven't “Ser inpud. rts looking 
@) using the GameHelper een it yet (you will). 
class Jf 
int guess = helper.getUserInput ("enter a number"); 
We ; . A method of the Gamettelper class 
teats anne variable to that asks the user for Command— 
he user input we aet b b oie haf 
(3, 5, ete.). get bac line input, reads it in after the 
user hits RETURN, and gives back 
the result as an int. 
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GameHelper class (Ready-bake) 


prep code test code 


One last class: GameHelper 


We made the Startup class. Just copy* the code below and compile it into a 
We made the game class class named GameHelper. Drop all three class files 
(SimpleStartup, SimpleStartupGame, GameHelper) into 


All that’s left is the helper class—the one with the the same directory, and make it your working directory. 


getUserInput() method. The code to get command-line 
input is more than we want to explain right now. It opens 
up topics best left for later. (Later, as in Chapter 16, Saving 
Objects.) 


Yes, we WILL 
take a little more 
of your delicious 
Ready-Bake Code, 
thank you very much! 


import Jjava.util.Scanner; 


public class GameHelper { 
public int getUserInput (String prompt) { 
System.out.print (prompt + ": "); 
Scanner scanner = new Scanner (System.in) ; 
return scanner.nextIint() ; 


*We know how much you enjoy typing, but for those rare moments 
when you'd rather do something else, we’ve made the Ready-Bake 
Code available on https://oreil.ly/hfJava_3e_examples. 
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Let’s play 


Here's what happens when we 
run it and enter the numbers 
1,2,3,4,5,6. Lookin’ good. 


A complete game interaction 
(your mileage may vary) 


Sjava SimpleStartupGame 
enter a number 1 
miss 

enter 

miss 

enter 

miss 

enter 

hit 

enter 

hit 

enter number 


kill 


You took 6 guesses 


writing a program 


What's this? A bug? 


Gasp! 
Here's what happens when we 
enter 1,1,1. 


A different game interaction 
(yikes) 


File Edit Window Help Faint 


Sjava SimpleStartupGame 


enter a number 1 
hit 
enter a number 1 
hit 
enter a number 1 
kill 


You took 3 guesses 


taherper your pencil 
aN 

} It’s a cliff-hanger! 
Will we find the bug? 

Will we fix the bug? 


Stay tuned for the next chapter, where we answer 
these questions and more... 


And in the meantime, see if you can come up with 
ideas for what went wrong and how to fix it. 


—-» Yours to solve. 
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for loops 


More about for loops 


We've covered all the game code for his chapter (but we'll pick it up again to finish 
the deluxe version of the game in the next chapter). We didn’t want to interrupt 
your work with some of the details and background info, so we put it back here. 
We'll start with the details of for loops, and if you’ve seen this kind of syntax in 
another programming language, just skim these last few pages... 


Regular (non-enhanced) for loops 


the Cod le to 
repeat Goes h 
post—inerement ane the body) = 
for Cint i = 0; 1 < 100; i++) { } repeat for 100 reps: 
Sa a 
t 
initialization boolean test iteration expression 


What it means in plain English: “Repeat 100 times.’ 
How the compiler sees it: 

=» create a variable j and set it to 0. 

» repeat while / is less than 100. 


» at the end of each loop iteration, add 1 toi. 


Part One: initialization 


Use this part to declare and initialize a variable to use within the loop body. 
You'll most often use this variable as a counter. You can actually initialize more 
than one variable here, but it's much more common to use a single variable. 


Part Two: boolean test 


This is where the conditional test goes. Whatever's in there, it must resolve to a 
boolean value (you know, true or false). You can have a test, like (x >= 4), or you 
can even invoke a method that returns a boolean. 


Part Three: iteration expression 


In this part, put one or more things you want to happen with each trip through 
the loop. Keep in mind that this stuff happens at the end of each loop. 
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Trips throughaloop «© 
for (int i= 0; i < 8; i++) { 
System. out.println (i) ; 

} 


System.out.println ("done") ; 


declare int i 
set i toO 


enter loop 
body 


print the value 
of i 


print “done” 
(jump below loop) 


increment i 
(the iteration 
expression) 


Difference between for and while 
—_ > 


A while loop has only the boolean test; it doesn’t have 
a built-in initialization or iteration expression. A while 
loop is good when you don’t know how many times to 
loop and just want to keep going while some condi- 
tion is true. But if you know how many times to loop 
(e.g., the length of an array, 7 times, etc.), a for loop is 
cleaner. Here’s the loop above rewritten using while: 


| a we hav 
int i = 0; <——~ niin yas and 
while (i < 8) { _ 


System. out.println (i) ; 


itt; <——— WM have 4 j, 


cr 
} € Counte, cent 


System.out.println ("done") ; 


writing a program 


File Edit Window Help Repeat 


java Test 


% 
0) 
1 
2 
3 
4 
5 
6 
7 


done 


++ 0 == 


Pre and Post Increment/Decrement Operator 


The shortcut for adding or subtracting 1 from a variable: 
Xtt+; 
is the same as: 
x =x+1; 
They both mean the same thing in this context: 
“add 1 to the current value of x” or “increment x by 1” 
And: 
X--; 
is the same as: 
x =x -1; 


Of course that’s never the whole story. The placement of the 
operator (either before or after the variable) can affect the re- 
sult. Putting the operator before the variable (for example, ++x), 
means, “first, increment x by 1, and then use this new value of x.” 
This only matters when the ++x is part of some larger expres- 
sion rather than just a single statement. 
int x = 0; int z = ++x; 
produces: xis1,zis 1 
But putting the ++ after the x gives you a different result: 
int x = 0; int z = x++; 


Once this code has run, xis 1, but zis 0! z gets the value of x, 
and then x is incremented. 
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enhanced for 


The enhanced for loop 


The Java language added a second kind of for loop called the enhanced for back in Java 

5. This makes it easier to iterate over all the elements in an array or other kinds of 
collections (you'll learn about other collections in the next chapter). That’s really all that the 
enhanced for gives you—a simpler way to walk through all the elements in the collection. 
We'll see the enhanced for loop in the next chapter too, when we talk about collections 
that aren’t arrays. 


. The Cod 
akeration 7 repeat. ao. o 
clave a” 1" A old he Colon (. Prat goes b 
varati, Oat dhe avvay: medns ye? “the body) , a 
ynoe ele™ 
sin) 


for (String name : nameArray) if } 
: e ou want to iterate over: 


The el ; ‘ kiom 3 ‘ Jements that Y oe 
cay ie be the With eath ae? a ww the The aes . pee earlier, the tode said 

i “ Levent 7 e . ed \o |magine t 3 yp » DB b"}; 
Compatible with the °°) be assis = {'Fred”, “Mary’ “Bob ® 


declared vari able type. array ~ le “name - String lI namefirray vas tie value of 
ote With the first iteration, the name variable ie of “Mary”, ett- 


iteration, a Va 
“Eyed”, and with the second iteratio 


What it means in plain English: “For each element in nameArray, assign the 
element to the ‘name’ variable, and run the body of the loop.” 


How the compiler sees it: ties minke hs 
Programming language they've 
» Create a String variable called name and set it to null. used in the Past, some people 
refer to the enhanced for as the 
or each or the “for in” loo ) 
» Run the body of the loop (the code block bounded by curly braces). evra that’s how it reads: ce 
ACH thing IN the collection...” 


» Assign the first value in nameArray to name. 


» Assign the next value in nameArray to name. 


» Repeat while there are still elements in the array. 


Part One: iteration variable declaration 


Use this part to declare and initialize a variable to use within the loop body. With each 
iteration of the loop, this variable will hold a different element from the collection. The 
type of this variable must be compatible with the elements in the array! For example, 
you can’t declare an int iteration variable to use with a String/] array. 


Part Two: the actual collection 


This must be a reference to an array or other collection. Again, don’t worry about the 
other non-array kinds of collections yet—you'll see them in the next chapter. 


116 chapter 5 


writing a program 


Casting primitives 


Before we finish the chapter, we want to tie up a loose end. When we used Math.random(), 
we had to cast the result to an int. Casting one numeric type to another can change the value 
itself. It's important to understand the rules so you’re not surprised by this. 


long ———_—_—__» short 
g can be cast to 


Bits o, 
th 
Xoy, ‘< “de were neat 
4 but you might “e) 


lose something 0 


In Chapter 3, Anow Your Variables, we talked about the sizes of the various primitives and how you can’t shove a big 
thing directly into a small thing: 

long y = 42; 

int x = y; // won't compile 
A long is bigger than an int, and the compiler can’t be sure where that long has been. It might have been out 
partying with the other longs, and taking on really big values. To force the compiler to jam the value of a bigger 
primitive variable into a smaller one, you can use the cast operator. It looks like this: 


long y = 42; // so far so good 

int x = (int) y; // x = 42 cool! 
Putting in the cast tells the compiler to take the value of y, chop it down to int size, and set x equal to whatever 1s 
left. If the value of y was bigger than the maximum value of x, then what’s left will be a weird (but calculable*) 
number: 

long y = 40002; // 40002 exceeds the 16-bit limit of a short 

short x = (short) y; // x now equals -25534! 
Still, the point is that the compiler lets you do it. And let’s say you have a floating-point number and you just want 
to get at the whole number (int) part of it: 

float £ = 3.14f; 

int x = (int) f; // x will equal 3 
And don’t even think about casting anything to a boolean or vice versa—just walk away. 


*It iwolves sign bits, binary, “two’s complement,” and other geekery. 


you are here > 


117 


exercise: Be the JVM 


BE the JVM. 


The Java file on this page 
represents a complete source 
MW file. Your job is to play JVM 


the output when the 
program runs. 


File Edit Window Help OM 


% java Output 
class Output { 12 14 


public static void main(String[] args) { 
Output output = new Output (); 


output.go(); 


-or- 
void go() { 


int value = 7; 


File Edit Window Help Incense 


java Output 


for (int i= 1; i < 8; itt) { 4 
1214 x=6 


valuet+; 

if (i > 4) { 
System.out.print(++value + " "); 

} 

if (value > 14) { 


System.out.printin(" i = " + i); 
break; or 
} 
; 
} % java Output 
} 13 15 x = 6 


————> Answers on page 122. 
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writing a program 


Code Magnets 


A working Java program is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 


System.out.println(i + " "+ 9); 


for (int 


for(int i = O; i < 4; itt) { 


File Edit Window Help Raid 


java MultiFor 
4 


0) 
0) 
1 
1 
3 
3 


————— Answers on page 122. 
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puzzle: JavaCross 


JavaCrass 


How does a crossword puzzle 
help you learn Java? Well, all 
of the words are Java related. 


In addition, the clues provide 
metaphors, puns, and the like. 


These mental twists and turns 
burn alternate routes to Java 


knowledge right into your 


Across 


1. Fancy computer word 
for build 


4, Multipart loop 

6. Test first 

7. 32 bits 

10. Method's answer 
11. Prep code-esque 
13. Change 

15. The big toolkit 
17. An array unit 


18. Instance or local 
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20. Automatic toolkit 


22. Looks like a primi- 
tive, but.. 


25. Un-castable 
26. Math method 
28. Iterate over me 


29. Leave early 


brain! 
Down 
2. Increment type 21. As if 
3. Class’s workhorse 23. Add after 
5. Preisatypeof_ 24, Pi house 
6. For'siteration 26. Compile itand___ 
7. Establish first value 27. ++ quantity 
8. While or For 
9. Update an instance variable 


12. Toward blastoff 
14. Acycle 
16. Talkative package 


19. Method messenger 
(abbrev.) 


————> Answers on page 123. 


Mixed 
Messages 


writing a program 


A short Java program is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left) with the output that you'd see if the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. 


———> Answers on page 123. 


public static void main(String[] args) { 


int x = 


int y 


for 


0; 


= 30; 


(int outer = 0; outer < 3; outert+t) { 


for 


y 
if 
} 
x 
} 
VY = 
} 
System 
} 
Candidates: 
5 Ss ae sie 
 S ox + Oe 
xXx = x + 2; 
RHP 
2S =F 
x Sox + Or 


(int inner = 4; inner > 1; inner--) { 


= fa Goes hee Code 
(x == 6) { 
break; 
=x + 3; 
y - 2; 
.out.printin(x +" "+ y); 
Possible output: 
45 6 Mateh each 
randidate with tie 
36m6 one ox the Poss! 
outputs 
54 6 
60 10 
1g 6 
6 14 
Zale 
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exercise solutions 


Exercise Solutions 


Be the JVM (from page 118) Code Magnets (from page 119) 
class Output { class MultiFor { 
public static void main(String[] args) { public static void main(String[] args) { 
Output output = new Output (); for (int i = 0; i < 4; itt) { 
output.go(); 
} for (int j7 = 4; j > 2; j--) { 
System.out.printin(i + " "+ 9); 
void go() { } 


int value = 7; 
for (int i= 1; i < 8; itt) { 


valuett; 
if (i > 4) { What would happen if 
System.out.print (++value + ""); } this code block came 
; } before the 'j’ for loop? 
if (value > 14) { } 
System.out.printin(" i =" + i); 
break; File Edit Window Help Monopole 
} 


java MultiFor 


Did you remember to factor in 
} the break statement? How did 


0) 
0 
1 
1 
that affect the output? 3 
3 


File Edit Window Help MotorcycleMaintenance 


% java Output 
SS x 
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writing a program 


P 5 
R O 
E E P E 
> D E N 
E D R I : 
aa okt rc i — I (from page 120) 
Ss TL IR O A 
S| JEILIE T R L 
I R}| iM LE 
O| |A| |E V A Zz 
N T; IN I E 
PIIN |T R 
O T ‘B E 
RAND/O U 
U N ‘A 
N| /B E L. 
Mixed 
Messages (from page 121) 
Candidates: Possible output: 
wm =e + Se As, 
xX = x + 6; 36 © 
ok ap We 54 6 
PxGiaals 60 10 
— 18 6 
x = ox a Op 6 14 
12 i4 
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6 get to know the Java API 


Using the Java Library 
. aml 


So 
it's true? We 
don't have to build 
it ourselves? 


Java ships with hundreds of prebuilt classes. You don't have to reinvent 
the wheel if you know how to find what you need in the Java library, known as the Java API. 
You've got better things to do. If you're going to write code, you might as well write only the 
parts that are truly custom for your application. You know those programmers who walk out 
the door each night at 5 PM? The ones who don't even show up until 10 AM? They use the 
Java API. And about eight pages from now, so will you. The core Java library is a giant pile of 
classes just waiting for you to use like building blocks, to assemble your own program out of 
largely prebuilt code. The Ready-Bake Java we use in this book is code you don't have to create 
from scratch, but you still have to type it. The Java API is full of code you don’t even have to 


type. All you need to do is learn to use it. 


this is anewchapter 125 


we still have a bug 


In our last chapter, we left you 
with the cliffhanger: a bug 


How it’s supposed to look How the bug looks 
Here's what happens when we Here's what happens when we 
run it and enter the numbers enter 2,2,2. 


1,2,3,4,5,6. Lookin’ good. 


A complete game interaction A different game interaction 
(your mileage may vary) (yikes) 


File Edit Window Help Faint 


Sjava SimpleStartupGame 


Sjava SimpleStartupGame 


enter a number 2 


hit 


enter a number 1 
miss 
enter a number 2 


hit 


enter 
miss 
enter a number 2 


kill 


enter 
miss 
enter 


hit 


You took 3 guesses 


enter 


hit In the current version, once 
enter a number you get a hit, you can simply 
kill repeat that hit two more 
You took 6 guesses times for the kill! 
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So what happened? 


Here’s where it 
goes wrong. We 


counted a hit every <p 


time the user 
guessed a cell 
location, even if 
that location had 
already been hit! 


We need a way to 
know that when 

a user makes a 

hit, they haven’t 
previously hit that 
cell. If they have, 
then we don’t want 
to count it as a hit. 


public String checkYourself(int guess) { 


Make a variabl 
String result = "miss"; — welll return, Pat oot ie 
s the 


default (i.e. we Assume a “miss”). 


for (int cell : locationCells) { 


R : 
0 , re at With eae} 
3 in the array, 
eo Compare the user 


uess to this ele 
eel in the weay. : 


if (guess == cell) { 


panels SS Meiteylo 


we got a hit! 
numOfHits++; <—— 


break; ¢— Get out of th : 
to test the ag ee 


} // end if 
} // end for 


if (numOfHits == locationCells.length) { €~ We're ot of the loop, but 
; oop, bu 
eUs see it we're now ‘dead’ 
Chit 3 Limes) and change the 


result = "kill"; 
result String to “kill”. 


} // end if 


System.out.println (result) ;< _ Display the result for the user “miss” 
unless it was changed to “hit” or “kill”). 


return result; 


K Return the result back to 


the Calling method. 
} // end method 
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fixing the bug 


How do we fix it? 


We need a way to know whether a cell has already been hit. Let's run 
through some possibilities, but first, we'll look at what we know so far... 


We have a virtual row of seven cells, and a Startup will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
Startup placed at cell locations 4, 5, and 6. 


The Startup has an instance variable—an int array—that holds that 
Startup object's cell locations. 


4 > 6 
The arra insta 
7 vance vari 
ae Startup cell loestie ble that: holds 
locationCells ir-tup holds th ons. This 
(instance variable of 0 | 1 | 2 » and & Tho. € three values of 4 
the Startup) user py € are the numb 
Pp eeds to Quess. ers th 


@) Option one 
We could make a second array, and each time the user makes a hit, we 


store that hit in the second array, and then check that array each time 
we get a hit, to see if that cell has been hit before. 


A ‘Liu’ ina 


q the cll leaton 3b tot na, th a 2y means tht 


array (locationCells) has hs re in the OTHER 


false false true 


This arr, 
e ( 


el ayh 

hitCells array 8 YJ the ‘stat, yoga, three values representing 
(this would be a | | | | location cells a tartup’s 
new boolean array 0 ! 2 at index 2 ig f: ‘A *ample fhe 
instance variable of he “hit » nen set index 2 ; 
the Startup) motel array to ‘true’, en 


128 chapter 6 


get to know the Java API 


Option one is too clunky 


Option one seems like more work than you'd expect. It means that each 
time the user makes a hit, you have to change the state of the second 
array (the hitCells array), oh—but first you have to CHECK the hitCells 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 


Option two 
We could just keep the one original array but change the value of any hit 
cells to -1. That way, we only have ONE array to check and manipulate. 


a-l ata arti . 
a is he a cell location means that the cell 


-1 negative numbers in the aay only looking or non— 


locationCells 
(instance variable of 
the Startup) 


Option two is a little better, but 
still pretty clunky 


Option two is a little less clunky than option one, but it's not very efficient. You'd 
still have to loop through all three slots (index positions) in the array, even if 
one or more are already invalid because they've been “hit" (and have a -1 value). 
There has to be something better... 
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prep code 


prep code (test code 


@) Option three 


We delete each cell location as it gets hit and then modify the array to 
be smaller. Except arrays can't change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 


smaller array. 
4 5% 6 


locationCells array 

BEFORE any cells of 3 with a size 

have been hit (posit co all 3 eells 
y) to look for 


the tell aa Suess and 


locationCells array 
AFTER cell ‘5’, which 
was at index 1 in the 


array, has been hit 4 
| 0 | 1 | 


Option three would be much better if the array could shrink so that we wouldn't have to 
make a new smaller array, copy the remaining values in, and reassign the reference. 


a 6 When ¢ell 'S’ ig hit, we make a new 


smaller array with onl i 
bee! cell locations, ae is it eo 
original locationCells reference. ° 


The original prep code for part of the Life would be good if only we could 
checkYourself() method: change it to: 
REPEAT with each of the location cells in the int array ——<—p REPEAT with each of the remaining location cells 
// COMPARE the user guess to the location cell // COMPARE the user guess to the location cell 
IF the user guess matches IF the user guess matches 
INCREMENT the number of hits ———-_====—_-_ REMOVE this cell from the array 
/I FIND OUT if tt was the last location cell: // FIND OUT if it was the last location cell: 
IF number of hits is 3, RETURN “kill” ——_—_——__—_} IF the array is now empty, RETURN “kill” 
ELSE it was nota kill, so RETURN “hit” ELSE it was not a kill, so RETURN “hit” 
END IF END IF 
ELSE user guess did not match, so RETURN “miss” ELSE user guess did not match, so RETURN “miss” 
END IF END IF 
END REPEAT END REPEAT 
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If only I could find an array 
that could shrink when you remove 
something. And one that you didn't have 
to loop through to check each element, but 
instead you could just ask it if it contains 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 
That would be dreamy. But I know it's 
just a fantasy... 
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when arrays aren’t enough 


Wake up and smell the library 


As if by magic, there really is such a thing 
But it’s not an array, it’s an ArrayList 


A class in the core Java library (the API) 


The Java Platform, Standard Edition (Java SE) ships with hundreds of pre- 
built classes. Just like our Ready-Bake Code. Except that these built-in classes 
are already compiled. 


That means no typing 


Just use ’em. 


addle e) 


is list. 
dof this lis 
h specified element to the en 
ppendst e 


ArrayList is one of a 


gazillion classes in the Java 
library. 


va osition. 
vemoven "ee nt at the specified P 
the & 
Re emov vest 


You ¢an use it in your tode 
as if you wrote it yourself 


nt. 
cified eleme 
remove(Ob a aoe occurrence of the spe 
e 
Re emov bee 


, nt. 
t 0) . ecified eleme 
contains\ObJe one jist contains te SP 
Returns true 


. elements. 
isEmpty!) s “true” if the list contains N° 
Retur 


indexOf (objec 


+ or-1- 
eelementy 
ith me first index of th 
Returns € 


; is list. 
, nts in this 
size\) ber of eleme 
he num 
Returns t 


(Note: the add(E e) method looks 
a little strange...we'll get to ig: 
Chapter II. 


or now, 


ust think of 
as an add() method aise takes th 
object You want to add.) 


oe osition. 
get(int index ne element at the specified P 
Returns t 


E 
This is just a sample of SOM 


of the methods PrvayList: 
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Some things you can do with ArrayList 


@ 


@ 


; is n > anale-bracket syntax 
Don't worry about se Sa nae : ae sos ite 


Make one oa Fight now; it just m 4 
; . 7 ‘ : ; rett is 
ArrayList<Egg> myList new ArrayList<Egg>(); ee evap oe ttle 


treated an 
it’s ere y: 
Put something in it because ' 


Egg eggl = new — ao | 
/ Now the PrerayList grows 3 box 


myList.add(eggl1) ; to hold the E99 object: 


Put another thing in it 


See ods ae ee The ArrayList ; 
the second Eog ee to hold 
myList.add(egg2) ; 
Find out how many things are in it des wack ahaliivs 2 abjetts _ 
eee een Se reeves the size() method returns 2: 
The AwrayList DOES contain the E99, object 


Find out if it contains something ’ 50 contains() returns 


ve referenced by ‘e99] 
boolean isIn = myList.contains (eggl1); true. 
—_— 


List is zero—based (means first index is Oo) 


Find out where something is (i.e., its index) ie re the abject velerented by ‘egg’ was the 
and sin 

ee ag een ee sroceeee ee second thing in the list, indexO£0 returns Le 

Find out if it's empty its definitely NOT empty, so isEmpty() 


boolean empty = myList.isEmpty () ; E— returns alse. 


Remove something from it / Hey look — it shrank! 


myList.remove (egg1) ; 
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when arrays aren’t enough 


iad your pencil Fill in the rest of the table below by looking at the ArrayList code 


on the left and putting in what you think the code might be if it 
were using a regular array instead. We don’t expect you to get all 
of them exactly right, so just make your best guess. 


ArrayList Regular array 


ArrayList<String> ‘call new String CJ myList = = new Stringl2J; 
ArrayList<String>() 

String a = "whoohoo"; String a = “whoohoo”; 
String b = "Frog"; String b= “Foo”; 
ES 


boolean isIn = myList.contains ( 
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thereareno 
b Questions 


* So ArrayList is cool, but 
how would | know it exists? 


A: The question is really, 
“How do | know what's in the 


API?” and that’s the key to your 
success as a Java programmer. 
Not to mention your key to 
being as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
most of the heavy lifting and 

all you have to do is step in and 
create the fun part. 


But we digress...the short answer 
is that you spend some time 
learning what's in the core API. 
The long answer is at the end of 
this chapter, where you'll learn 
how to do that. 


Q: But that’s a pretty big 
issue. Not only do I need to 
know that the Java library 
comes with ArrayList, but more 
importantly | have to know 
that ArrayList is the thing that 
can do what I want! So how 

do | go from a need-to-do- 
something to a-way-to-do-it 
using the API? 


A: Now you're really at the 
heart of it. By the time you've 
finished this book, you'll have 

a good grasp of the language, 
and the rest of your learning 
curve really is about knowing 
how to get from a problem to 

a solution, with you writing the 
least amount of code. If you can 
be patient for a few more pages, 
we start talking about it at the 
end of this chapter. 
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Java Exposed 


This week’s interview: 
ArrayList, on arrays 


HeadFirst: So, ArrayLists are like arrays, right? 
ArrayList: In their dreams! J am an olject, thank you very much. 


HeadFirst: If I’m not mistaken, arrays are objects too. They live on the heap right 
there with all the other objects. 


ArrayList: Sure arrays go on the heap, duh, but an array is still a wanna-be 
ArrayList. A poser. Objects have state and behavior, right? We’re clear on that. But 
have you actually tried calling a method on an array? 


HeadFirst: Now that you mention it, can’t say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put a the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 


ArrayList: Is that so? You mean to tell me you actually removed something from an 
array? (Sheesh, where do they érain you guys?) 


HeadFirst: Of course I take something out of the array. I say Dog d = dogArray[1], 
and I get the Dog object at index | out of the array. 


ArrayList: Alright, I’ll try to speak slowly so you can follow along. You were not, I 
repeat nol, removing that Dog from the array. All you did was make a copy of the 
reference to the Dog and assign it to another Dog variable. 


HeadFirst: Oh, I see what you’re saying. No, I didn’t actually remove the Dog 
object from the array. It’s still there. But I can just set its reference to null, I guess. 


ArrayList: But I’m a first-class object, so I have methods, and I can actually, you 
know, do things like remove the Dog’s reference from myself, not just set it to null. 
And I can change my size, dynamically (look it up). Just try to get an array to do that! 


HeadFirst: Gee, hate to bring this up, but the rumor is that you’re nothing more 
than a glorified but less-efficient array. That in fact you’re just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself. And while we’re at it, you can’t even hold primitives! Isn’t that a big limitation? 


ArrayList: I can’t believe you buy into that urban legend. No, I am not just a less- 
efficient array. I will admit that there are a few extremely rare situations where an 
array might be just a tad, I repeat, fad bit faster for certain things. But is it worth the 
miniscule performance gain to give up all this power? Still, look at all this flexebelity. And 
as for the primitives, of course you can put a primitive in an ArrayList, as long as it’s 
wrapped in a primitive wrapper class (you'll see a lot more on that in Chapter 10). 
And if you’re using Java 5 or above, that wrapping (and unwrapping when you take 
the primitive out again) happens automatically. And alright, Pll acknowledge that yes, 
if youre using an ArrayList of primitives, it probably is faster with an array, because 
of all the wrapping and unwrapping, but still...who really uses primitives these days? 


Oh, look at the time! ’m late for Pilates. We'll have to do this again sometime. 
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difference between ArrayList and array 
Solution 
eerpe your pencil (from page 134) 

ON 


ArrayList Regular array 


ArrayList<String> myList = new String [] myList = new String[2]; 
List<String>(); 


String a = "whoohoo"; String a = "whoohoo"; 


myList.add(a) ; myList[0] = a; 
String b = "Frog"; String b = "Frog"; 
myList.add(b) ; myList[1] = b; 


boolean isIn = myList.contains (b); boolean isIn = false; 


for (String item : myList) { 
if (b.equals(item)) { 
isIn = true; 


break; 


Notice how with ArrayList, you’re working with With an array, you use special array syntax (like 

an object of type ArrayList, so you’re just invoking myList[0] = foo) that you won’t use anywhere else 
regular old methods on a regular old object, using except with arrays. Even though an array is an 
the regular old dot operator. object, it lives in its own special world, and you 


can’t invoke any methods on it, although you can 
access its one and only instance variable, length. 
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Comparing ArrayList to a regular array 


@) A plain old array has to know its ® Arrays use array syntax that’s not 
size at the time it’s created. used anywhere else in Java. 
But for ArrayList, you just make an object of type But ArrayLists are plain old Java objects, so they 
ArrayList. Every time. It never needs to know how have no special syntax. 


big it should be, because it grows and shrinks as ngiveuray 
objects are added or removed. 7 


new String[2] Needs a sizé- The array brackets C J are special syn- 


tax used only for arrays: 
new ArrayList<String>() 
No size required (although You can 
give it an initial size if You want to). 


@) ArrayLists are parameterized. 
@ To put an object in a regular array, 


you must assign it to a specific We just said that unlike arrays, ArrayLists have 


no special syntax. But they do use something 


location. ; . 
(An index from 0 to one less than the length of ap panenb terse Ones: 
the array.) ArrayList<String> 
myList[1] = b; 
~ The <String> in angle brackets is a “type 
Needs an index. parameter. ArrayList<String> means simply “a 


list of Strings,” as opposed to ArrayList<Dog>, 
which means, “a list of Dogs.” 


If that index is outside the boundaries of the array 
(like the array was declared with a size of 2, and 
now you're trying to assign something to index 3), 
it blows up at runtime. 


Using the <TypeGoesHere> syntax, we can 
declare and create an ArrayList that knows 
(and restricts) the types of objects it can hold. 
We'll look at the details of parameterized types 
add(anInt, anObject) method, or you can just keep in ArrayLists in Chapter 11, Data Structures, 
saying add(anObject) and the ArrayList will keep 
growing to make room for the new thing. 


With ArrayList, you can specify an index using the 


so for now, don’t think too much about the 
angle bracket <> syntax you see when we use 
myList.add(b) ; ArrayLists. Just know that it’s a way to force the 
compiler to allow only a specific type of object 
No ind ee (the type in angle brackets) in the ArrayList. 


*Parameterized types were added to Java in Java 
5, which came out so long ago that you are almost 
definitely using a version that supports them! 
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the buggy Startup code 


prep code test code 


Let’s fix the Startup code 


Remember, this is how the buggy version looks: 


(instead of 
) amed the Class Startup now aS ie 
edie ai — . leStar tu) for the new ann mS 

ae same Code You Saw in the last chapter: 


private int[] locationCells; 
private int numOfHits = 0; 


public void setLocationCells(int[] locs) { 


locationCells = locs; 


public String checkYourself(int guess) { 


String result = "miss"; 
for (int cell : locationCells) { 
if (guess == cell) { Where it all w 
westllic = Winaies os Counted ath 2 Wrong. We 
numOfHits++; without chee. ° ess as hit, 
tell had already beer fre rae 
break; a 


} 

} // end for 

if (numOfHits == locationCells.length) { 
result = "kill"; 

} // end if 

System.out.printin(result); 


return result; 
} // end method 
} // close class 
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prep code test code 


New and improved Startup class 


import java.util.ArrayList; 

public class Startup { 
private ArrayList<String> locationCells; ot that holds Strings: 
// private int numOfHits; R_ Change the int array to an AyrayList 


// don't need to track this now v 


public void setLocationCells (ArrayList<String> locs) { 
locationCells = locs; ent name 


This is now 2 String = it needs _— 
to accept a value like A3. we vey wt 


3yList, b askin . £() 
public String checkYourself (String userInput) { re ask athe list, then indexO 


String result = "miss"; returns 2 —!- 
int index = locationCells.indexOf (userInput) ; 


If index ; 
if (index >= 0 Y Se eX Is Oreate 
if (i = 4 the user Suess is ae fear or equal to Zero, 
remove it, nitely in the list, so 
locationCells.remove (index) ; <—— 


i If the list is empty, this 
if (locationCells.isEmpty()) { Pe rine Wee 
result = "kill"; < 
} else { 
result = “hit? 
} // end if 
} // end outer if 
return result; 
} // end method 
} // close class 
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making the StartupBust 


Let’s build the REAL game: 
“Sink a Startup” 


We've been working on the “simple” version, but now let’s 
build the real one. Instead of a single row, we’ll use a grid. 
And instead of one Startup, we’ll use three. 


Goal: Sink all of the computer’s Startups in the fewest 
number of guesses. You’re given a rating level based on 
how well you perform. 


Setup: When the game program is launched, the 
computer places three Startups, randomly, on the virtual 
7x7 grid. When that’s complete, the game asks for your 
first guess. 


How you play: We haven’t learned to build a GUI yet, 
so this version works at the command line. The computer 
will prompt you to enter a guess (a cell), which you'll type 
at the command line (as “A3,” “C5,” etc.). In response to 
your guess, you'll see a result at the command-line, either 
“hit,” “miss,” or “You sunk poniez” (or whatever the lucky 
Startup of the day is). When you’ve sent all three Startups 
to that big 404 in the sky, the game ends by printing out 
your rating. 


= 


0 AN BB 


“starts ab zero; like Java array 
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You’re going to build the 
Sink a Startup game, with 
a 7x7 grid and three 
Startups. Each Startup 
takes up three cells. 


part of a game interaction 


File Edit Window Help Sell 


Sjava StartupBust 
Enter a guess A3 
miss 

Enter a guess B2 
miss 

Enter guess 
miss 

Enter guess 

hit 

Enter a guess D3 
hit 

Enter a guess D4 
Ouch! You sunk poniez 


kill 


Enter a guess G3 
hit 


Enter a guess 

hit 

Enter a guess G5 

Ouch! You sunk hacqi a 


All Startups are dead! Your stock 
is now worthless 


Took you long enough. 62 guesses. 


What needs to change? 


We have three classes that need to change: the Startup class 
(which is now called Startup instead of SimpleStartup), the 
game class (StartupBust), and the game helper class (which 
we won't worry about now). 


A) Startup class 


=" Adda name variable 
to hold the name of the Startup (“poniez,” 
“cabista,” etc.) so each Startup can print its 
name when it’s killed (see the output screen on 
the opposite page). 


© StartupBust class (the game) 


=" Create three Startups instead of one. 


=" Give each of the three Startups a name. 
Call a setter method on each Startup instance 
so that the Startup can assign the name to its 
name instance variable. 
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StartupBust class continued... 


Put the Startups on a grid rather than 
just a single row, and do it for all three 
Startups. 

This step is now way more complex than 
before, if we’re going to place the Startups 
randomly. Since we’re not here to mess with 
the math, we put the algorithm for giving 

the Startups a location into the GameHelper 
(Ready-Bake Code) class. 


Check each user guess with all three 
Startups, instead of just one. 


Keep playing the game (i.c., accepting user 
guesses and checking them with the remaining 
Startups) until there are no more live 
Startups. 


Get out of main. We kept the simple one in 
main just to...keep it simple. But that’s not what 
we want for the real game. 


3 Classes: 


StartupBust 


The game class. The actual 


GameHelper 


The helper class Plus four 


Makes Startups, Startup objects. (Ready-Bake ArrayLists: 

gets user input, Startups know their Code). It knows one for the 

plays until all Start- name, location, and how to accept user StartupBust and 
ups are dead. how to check a user command-line one for each 


5 Objects: 


guess for a match. input, and make of the three 


Startup locations. Startup obj a 


Std 
StartupBust ST GameHelper 
Startup 
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detailed structure of the game 


Who does what in the StartupBust game 


(and when) 
StartupBust The main() method 
The game instantiates in the StartupBust 
1) class. class instantiates the 


StartupBust object that 
does all the game stuff. 


StartupBust 
object 


instantiates 


ao staal The StartupBust (game) 

object instantiates an 
2) instance of GameHelper, 
the object that will help 

StartupBust the game do its work. 


object 


The StartupBust object 
instantiates an ArrayList 
that will hold the three 


GameHelper Startup objects. 


object 


StartupBust 
object 


ArrayList object (to 
hold Startup objects) 
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The StartupBust object 
creates three Startup 
objects (and puts them in 
the ArrayList). 


GameHelper 


StartupBust 
object ArrayList object to 


hold Startup objects Steetup 


objects 


The StartupBust object gives each of 

the Startup objects a location (which the 
StartupBust got from the helper object) like 
“A2,""B2," etc. Each Startup object puts his 
own three location cells in an ArrayList. 


The StartupBust object asks the 
helper object for a location fora 
Startup (does this three times, one 
for each Startup). 


ArrayList object 
(to hold Startup 
cell locations) 


StartupBust 
object 
ArrayList 
ArrayList object to object 
hold Startup objects ee 
The StartupBust object asks the The StartupBust object loops through the list of 


Startups, and asks each one to check the user guess 
for a match. Each Startup checks its locations 
ArrayList and returns a result (“hit," “miss,” etc.). 


helper object for a user guess (the 
helper prompts the user and gets input 
from the command line). 


S 
er gues 
ae 


nere ir 1S 


GameHelper ArrayList object 


(to hold Startup 
cell locations) 


StartupBust eer EE ee Veet tell i object 
object Storia ¢ Wy 


ArrayList 


And so the game continues...getting 
object 


user input, asking each Startup to ArrayList object to 
check for a match, and continuing hold Startup objects 
until all Startups are dead 


Startup 
objects 
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the StartupBust class (the game) 


prep code Fe code 
StartupBust 


GameHelper helper 
ArrayList startups 
int numOfGuesses 


setUpGame() 


startPlaying() 


checkUserGuess() 


finishGame() 


Variable 


Declarations 


Method 


Declarations 


Method 


Implementations 
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Prep code for the real StartupBust class 


The StartupBust class has three main jobs: set up the game, play the game until 

the Startups are dead, and end the game. Although we could map those three jobs 
directly into three methods, we split the middle job (play the game) into two methods 
to keep the granularity smaller. Smaller methods (meaning smaller chunks of func- 
tionality) help us test, debug, and modify the code more easily. 


DECLARE and instantiate the GameHelper instance variable, named helper. 
DECLARE and instantiate an ArrayList to hold the list of Startups (initially three) Call it startups. 


DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 


DECLARE a setUpGame() method to create and initialize the Startup objects with names and 
locations. Display brief instructions to the user. 


DECLARE a startPlaying() method that asks the player for guesses and calls the 
checkUserGuess() method until all the Startup objects are removed from play. 


DECLARE a checkUserGuess() method that loops through all remaining Startup objects and 
calls each Startup object's checkYourself() method. 


DECLARE a finishGame() method that prints a message about the user’s performance, based 
on how many guesses it took to sink all of the Startup objects. 


METHOD: void setUpGame() 
// make three Startup objects and name them 
CREATE three Startup objects. 
SET a name for each Startup. 
ADD the Startups to startups (the ArrayList). 
REPEAT with each of the Startup objects in the startups List: 


CALL the placeStartup() method on the helper object, to get a randomly-selected 
location for this Startup (three cells, vertically or horizontally aligned, on a 7 X 7 grid). 


SET the location for each Startup based on the result of the placeStartup() call. 
END REPEAT 
END METHOD 
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prep code | code 


Method implementations continued: 


METHOD : void startPlaying() 
REPEAT while any Startups exist. 
GET user input by calling the helper getUserInput() method. 


EVALUATE the user's guess by checkUserGuess() method. 
END REPEAT 


END METHOD 


METHOD: void checkUserGuess (String userGuess) 
// find out if there’s a hit (and kill) on any Startup 
INCREMENT the number of user guesses in the numOfGuesses variable. 
SET the local result variable (a String) to “miss”, assuming that the user's guess will be a miss. 
REPEAT with each of the Startup objects in the startups List. 
EVALUATE the user's guess by calling the Startup object's check Yourself() method. 
SET the result variable to “hit” or “kill” if appropriate. 


IF the result is “kill”, REMOVE the Startup from the startups List. 
END REPEAT 


DISPLAY the result value to the user. 
END METHOD 


METHOD ‘void finishGame() 
DISPLAY a generic ‘game over” message, then: 
IF number of user guesses is small, 


DISPLAY a congratulations message. 


ELSE 
DISPLAY an insulting one. 
END IF 
END METHOD 
; —— Yours to solve. 
iad your pencil 
aN 


How should we go from prep code to the methods. And which method do you test 
final code? First we start with test code, and and write first? See if you can work out some 
then test and build up our methods bit by prep code for a set of tests. Prep code or 

bit. We won't keep showing you test code even bullet points are good enough for this 


in this book, so now it’s up to you to think exercise, but if you want to try to write the 
about what you'd need to know to test these real test code (in Java), knock yourself out. 
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the StartupBust code (the game) 


prep code test code 


import java.util.ArrayList; 


public class StartupBust { 
private GameHelper helper = new GameHelper (); 


@) private ArrayList<Startup> startups = new ArrayList<Startup>(); 


private int numOfGuesses = 0; 


private void setUpGame() { 

// first make some Startups and give them locations 
Startup one = new Startup(); 
one.setName ("poniez") ; 
Startup two = new Startup(); 
two.setName ("hacqi") ; Q) 
Startup three = new Startup(); 
tc 
s 
s 
s 


hree.setName ("Ccabista") ; 
tartups.add(one); 
tartups.add(two); 
tartups.add(three) ; 


System.out.printin("Your goal is to sink three Startups."); 
System.out.printlin("poniez, hacqi, cabista"); 


oer your pencil 


Annotate the code 
yourself! 


Match the annotations 
at the bottom of each 
page with the numbers 

in the code. Write the 
number in the slot in front 
of the corresponding 
annotation. 


You'll use each annotation 
just once, and you'll need 
all of the annotations. 


@ 


System.out.println("Try to sink them all in the fewest number of guesses"); 


startups) { ® 


for (Startup startup 


ArrayList<String> newLocation = helper.placeStartup (3); 6) 


startup.setLocationCells (newLocation) ; © 
} // close for loop 
} // close setUpGame method 


private void startPlaying 
while (!startups.isEmpty () 


'@ 


checkUserGuess (userGuess 
} // close while 
finishGame () ; 

} // close startPlaying method 


, 


() 

- 
String userGuess = helper.getUserInput ("Enter a guess"); 

i 


_ Ask the helper for a Startup location 


— Call our own CheckUser-Guess method 


_As long as the Startup 
list is NOT empty 


Declare and ne e Get user input ere Sans telah 
Ww = 
— khe variables We Oiiock 
_ Print brief to give aS 4 on this Startup 
~~ instructions or rom the helper You just got 
user 
Startup objects, give em 
ae ed pi ek mes tre ArrayList 


~— Call our own finishGame method 
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prep code test code 


private void checkUserGuess (String userGuess) { Whatever you do, 
numOfGuesses++; 1) DON’T turn the 
String result = "miss"; (2) page! 
for (Startup startupToTest : startups) { (3) Not until you’ve 
result = startupToTest.checkYourself (userGuess) ; finished this 
exercise. 
if (result.equals("hit")) { 
break; 3 2 
} (15) Our version is on 
if (result.equals("kill")) { me HOxtPAae: 
startups.remove (startupToTest) ; ——) 
break; 


} 
} // close for 


System.out.printlin(result) ; (@) 
} // close method 


private void finishGame() { 
System.out.println("All Startups are dead! Your stock is now worthless") ; 


if (numOfGuesses <= 18) { 


System.out.printin("It only took you " + numOfGuesses + " guesses."); 
System.out.printin("You got out before your options sank."); 

} else { 
System.out.printin("Took you long enough. " + numOfGuesses + " guesses."); 


System.out.printin("Fish are dancing with your options"); 


} 
} // close method 


public static void main(String[] args) { 
StartupBust game = new StartupBust () ; @@) 
game.setUpGame () ; 
game.startPlaying(); 1) 

} // close method 


__ Repeat. with all Startups in the list a ars 
__ This one’s dead, so take ; —Print a message telling the result for 
Startups list Bien get a ine ie user how they did in the Game the user Tell th oe 
__ le € Jame objec 
Increment the number of guesses the user haswege to set up the game 
__ Assume it’s a ‘miss, unless told otherwise 
Tell th to check the user guess, 
Get out of the lo CN the game obi m __ Ask the Startup to che 
early, no point in tata aot pay loop ee peed the main looking for a hit (or kill) 
¢ others na’ checking the Suess ee _— Create the game object 
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the StartupBust code (the game) 


prep code test code 


import java.util.ArrayList; 


anitialize 
Declare el need: 


public class StartupBust { Lhe vavid 


private GameHelper helper = new GameHelper (); 
private ArrayList<Startup> startups = new ArrayList<Startup>(); 
private int numOfGuesses = 0; 


private void setUpGame() { 

// first make some Startups and give them locations 
Startup one = new Startup(); 
ne.setName ("poniez") ; 
tartup two = new Startup(); 
wo.setName ("hacqi") ; Make three Startup abjetts, 
tup three = new Startup(); we “em names) and stick em 
hree.setName ("cabista"); in the Arrayls 
tartups.add(one) ; 
tartups.add(two) ; 


Print brief 


tartups.add(three) ; instructions for user. 


A Wn tM rN O 
ct 
@ 
Kh 
53 


System.out.printin("Your goal is to sink three Startups."); 

System.out.printin("poniez, hacqi, cabista"); 

System.out.println("Try to sink them all in the fewest number of guesses"); 
Repeat with each Startup in me an helper for a 

for (Startup startup : startups) { nx Sky totation (ain 

ArrayList<String> newLocation = helper.placeStartup (3) i ArrayList. of Strings). 

startup.setLocationCells (newLocation) ; € Call the settey meth 


} // close for loop Startu to give 4 a TA a 
} // close setUpGame method Just got from the helper. salt 


eh 3 lm OT, it’s 
private void startPlaying() { hs long, as the Startup ar Or eea pee 
while (!startups.isEmpty()) { & the same as (starbups-isemp ee 
String userGuess = helper.getUserInput ("Enter a guess"); e Get user input. 
checkUserGuess (userGuess) ; 
— Call 
} // close while oon CheckUser-Guess method. 


finishGame(); ¢—— Call our own finishGame method. 
} // close startPlaying method 
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prep code test code 


rivate void checkUserGuess (String userGuess) of 
: ecco Lhe number of guesses the user has made 


numOfGuessest+; 
Assume it’s a ‘miss’, unless told otherwise 


String result = "miss"; €— 


in the list 
for (Startup startupToTest : startups) { <— Repeat with all Startups neh 


result = startupToTest.checkYourself (userGuess) ; g~ Ask the Startup to check pial 
guess, looking Lor a hit Cor kill 


if (result.equals("hit")) { Get out of co ae 
arly, i 
break; a— in testing the eile ly, no point 
} 
if (result.equals("kill")) { Thien’ 
one's dead, so take it out of 
startups.remove(startupToTest) ; a . out of the 
ae Startups list then get out of the loop 


} 
} // close for 


System.out.println (result) ;}@— Print the result for the user 
} // close method 


Print a message telling th 
user how they did in The ase 


private void finishGame() { 
System.out.println("All Startups are dead! Your stock is now worthless"); 
if (numOfGuesses <= 18) { 


System.out.printin("It only took you " + numOfGuesses + " guesses."); 
System.out.printin("You got out before your options sank."); 

} else { 
System.out.printin("Took you long enough. " + numOfGuesses + " guesses."); 


System.out.printin("Fish are dancing with your options"); 


} 
} // close method 


public static void main(String[] args) { C 
StartupBust game = new StartupBust (); e— reate the 9ame ob; 
game .setUpGame () ; —— Tell the Jame ob; 
game.startPlaying(); CM —_ Tell the 
a a 
} // close method Jame Play bet to sta 
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the Startup code 


prep code test code 


The final version of the 
Startup class 


import java.util.ArrayList; 


de iables: 
public class Startup { Startup's instante varia 
private ArrayList<String> locationCells; - an AvrayList of cell locations 
private String name; ~ the Startup’s name 


hod that 
public void setLocationCells (ArrayList<String> loc) { «— ie ae 
wi 


locationCells = loc; ets i 
location provided by the 
Gameltelper plateStartupl? 
. 7 
public void setName (String n) {¢—— Yourr basi setter method method 
name = Nn; | 
The ArrayList indexO£( ) method in 
action! id the user guess is one he 
entries in the ArrayList, indexOf ) 
public String checkYourself (String userInput) { will vetuen its ArrayList location. | 
String result = "miss"; not, indexOFC ) will veturn I. 
int index = locationCells.indexOf (userInput) ; L— 


if (index >= 0) { 


Using, ArvayList’s removel) method to delete an entry. 
locationCells. remove (index) ; =. 


if (locationCells.isEmpty()) { ee Using the isEmpty() method to see if all 


_Luocationtelis, of the locations have been guessed 
System.out.printin("Ouch! You sunk " + name + " : ( "); 
} else { ~ 
eas, Tell th 
| € user when g Startup has b 
"Eome = een sunk. 


} // end outer if 
return result; 


} // end method Return: ‘miss’ or ‘hit? or SgilP 
uy. 


} // close class 
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Super powerful Boolean expressions 


So far, when we've used Boolean expressions for our loops or if 
tests, they've been pretty simple. We will be using more powerful 
boolean expressions in some of the Ready-Bake Code you're about to 
see, and even though we know you wouldn't peek, we thought this 
would be a good time to discuss how to energize your expressions. 


“And” and “Or” Operators (&&, || ) 


Let's say you're writing a chooseCamera( ) method, with lots of rules 
about which camera to select. Maybe you can choose cameras 
ranging from $50 to $1000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 


“If the price range is between $300 and $400, then choose X.” 


if (price >= 300 && price < 400) { 
camera = "X"; 


} 


Let’s say that of the ten camera brands available, you have some logic 
that applies to only a few of the list: 


if (brand.equals("A") || brand.equals("B")) { 
// do stuff for only brand A or brand B 
} 


Boolean expressions can get really big and complicated: 


if ((zoomType.equals ("optical") && 
(zoomDegree >= 3 && zoomDegree <= 8)) || 
(zoomType.equals ("digital") && 
(zoomDegree >= 5 && zoomDegree <= 12))) { 
// do appropriate zoom stuff 
} 


If you want to get really technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 
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Not equals (!= and !) 
Let’s say that you have a logic like “of the ten available 
camera models, a certain thing is true for all but one.” 


if (model != 2000) { 
// do non-model 2000 stuff 


~ 


or for comparing objects like strings... 


if ('brand.equals("X")) { 
// do non-brand X stuff 
} 


Short-Circuit Operators ( &&, || ) 


The operators we've looked at so far, && and ||, are 
known as short-circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 


Similarly, with ||, the expression will be true if either side is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn't bother to 
check the right side. 


Why is this great? Let's say that you have a reference 
variable and you're not sure whether it’s been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e., no object has been assigned), 
you'll get a NullPointerException. So, try this: 


if (refVar != null && 
refVar.isValidType()) { 
// do ‘got a valid type’ stuff 
} 


Non-Short-Circuit Operators ( & , | ) 


When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 

they force the JVM to always check both sides of the 
expression. Typically, & and | are used in another context, 
for manipulating bits. 
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Ready-Bake: GameHelper 


This is the helper class for the game. Besides the user input method (that 
prompts the user and reads input from the command line), the helper’s Big 
Service is to create the cell locations for the Startups. We tried to keep it fairly 
small so you wouldn't have to type so much. And remember, you won't be able 
to compile the StartupBust game class until you have this class. 


import java.util.*; 


public class GameHelper { 
private static final String ALPHABET = "abcdefg"; 
private static final int GRID LENGTH = 7; 
private static final int GRID SIZE = 49; 
private static final int MAX ATTEMPTS = 200; 


static final int HORIZONTAL INCREMENT = 1; // A better way to represent these two 


static final int VERTICAL INCREMENT = GRID | 


ENGTH; // things is an enum (s Appendix B) 


Fl 
x 


private final int[] grid = new int[GRID_ SIZI Note: For extra credit, you might 


pe vaue ae Random random = new Random() ; ty “un—Commenting.” the 
private int startupCount = 0; System ei printhn’ sj Mak to wateh 
it work! These "print statements will 
public String cdieh bellies eigenen prompt) { let - “eheat” by giving you the 
SYSCen Outs Prine tprompe roe oie ; ion of the Startups, but it will 
Scanner scanner = new Scanner (System.in); eee 
return scanner.nextLine().toLowerCase(); 
} //end getUserInput 
public ArrayList<String> placeStartup(int startupSize) { 
// holds index to grid (0 - 48) 
int[] startupCoords = new int[startupSize]; // current candidate co-ordinates 
int attempts = 0; // current attempts counter 
boolean success = false; // flag = found a good location? 
startupCountt+; // nth Startup to place 
int increment = getIncrement (); // alternate vert & horiz alignment 
while (!success & attempts++ < MAX ATTEMPTS) { // main search loop 
int location = random.nextInt (GRID SIZE); // get random starting point 
for (int i = 0; i < startupCoords.length; i++) { // create array of proposed coords 
startupCoords[i] = location; // put current location in array 
location += increment; // calculate the next location 
} 
// System.out.printlin("Trying: " + Arrays.toString(startupCoords) ); 
if (startupFits(startupCoords, increment)) { // startup fits on the grid? 
success = coordsAvailable(startupCoords) ; // ...and locations aren't taken? 
} // end loop 
} // end while 
savePositionToGrid(startupCoords) ; // coords passed checks, save 
ArrayList<String> alphaCells = a en er eee re 
// System.out.printin("Placed at: "+ alphaCells) ibe ent that 
return alphaCells; a This is the sta ro be 
} //end placeStartup tells you exactly where 
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j= a Ready-Bake 
=i Cade GameHelper class code continued... 


private boolean startupFits(int[] startupCoords, int increment) { 
int finalLocation = startupCoords[startupCoords.length - 1]; 
if (increment == HORIZONTAL INCREMENT) { 
// check end is on same row as start 
return calcRowFromIndex(startupCoords[0]) == calcRowFromIndex (finalLocation) ; 
} else { 
return finalLocation < GRID SIZE; // check end isn't off the bottom 


} 
} //end startupFits 


private boolean coordsAvailable(int[] startupCoords) { 
for (int coord : startupCoords) { // check all potential positions 
if (grid[coord] != 0) { // this position already taken 
// System.out.printlin("position: " + coord + " already taken."); 
return false; // NO success 
} 
} 
return true; // there were no clashes, yay! 


} //end coordsAvailable 

private void savePositionToGrid(int[] startupCoords) { 
for (int index : startupCoords) { 

grid[index] = 1; // mark grid position as ‘used! 

} 

} //end savePositionToGrid 

private ArrayList<String> convertCoordsToAlphaFormat(int[] startupCoords) { 
ArrayList<String> alphaCells = new ArrayList<String>(); 


for (int index : startupCoords) { // for each grid coordinate 
String alphaCoords = getAlphaCoordsFromIndex (index); // turn it into an "a0" style 
alphaCells.add(alphaCoords) ; // add to a list 

} 

return alphaCells; // veturn the "a0"-style coords 


} // end convertCoordsToAlphaFormat 

private String getAlphaCoordsFromIndex (int index) { 
int row = calcRowFromIndex (index) ; // get row value 

int column = index % GRID LENGTH; // get numeric column value 
String letter = ALPHABET.substring(column, column + 1); // convert to letter 
return letter + row; 

} // end getAlphaCoordsFromIndex 

private int calcRowFromIndex(int index) { 
return index / GRID LENGTH; 

} // end calcRowFromIndex 

private int getIncrement() { 


if (startupCount % 2 == 0) { // if EVEN Startup 
return HORIZONTAL INCREMENT; // place horizontally 
} else { // else ODD 
return VERTICAL INCREMENT; // place vertically 


} 
} //end getIncrement 
} //end class 


This code, and a basie test, is available in the GitHub 
repo, https://oreil.ly/hfJava_3e_examples 
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API packages 


Using the Library (the Java API) 


You made it all the way through the StartupBust game, thanks 
to the help of ArrayList. And now, as promised, it’s time to 
learn how to fool around in the Java library. 


In the Java API, classes 
are grouped into packages. 


To use a class in the API, you 
have to know which package 
the class is in. 


Every class in the Java library belongs to a package. The 
package has a name, like javax.Swing (a package 
that holds some of the Swing GUI classes you'll learn 
about soon). ArrayList is in the package called java. 
util, which surprise surprise, holds a pile of wiility classes. 
You'll learn a lot more about packages in Appendix 

B, including how to put your own classes into your own 
packages. For now, though, we’re just looking to use some 
of the classes that come with Java. 


Using a class from the API, in your own code, is simple. 
You just treat the class as though you wrote it yourself... 
as though you compiled it, and there it sits, waiting for 
you to use it. With one big difference: somewhere in your 
code you have to indicate the fud/ name of the library 
class you want to use, and that means package name + 
class name. 


Even if you didn’t know it, you’ve already been using 
classes from a package. System (System.out.println), 
String, and Math (Math.random()) all belong to the 
java.lang package. 
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You have to know the full name* of the 
class you want to use in your code. 


ArrayList is not the full name of ArrayList, just as Kathy isn’t a full name 
(unless it’s like Madonna or Cher, but we won’t go there). The full name of 
ArrayList is actually: 


java.util .ArrayList 
wo—™~__4 —_—__— 


Package name elass name 


You have to tell Java which ArrayList you want to 
use. You have two options: 


IMPORT 
@ Put an import statement at the top of your source code file: 


import java.util.ArrayList; 
public class MyClass {... } 


OR 


TYPE 
©} Type the full name everywhere in your code. Each time you use it. 
Everywhere you use it. 


When you declare and/or instantiate it: 
java.util .ArrayList<Dog> list = new java.util .ArrayList<Dog>() ; 


When you use it as an argument type: 
public void go(java.util.ArrayList<Dog> list) { } 


When you use it as a return type: 


public java.util.ArrayList<Dog> foo() {...} 


*Unless the class is in the java.lang package. 
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when arrays aren’t enough 
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there, are no 


Dumb Questions 


: Why does there have to 
be a full name? Is that the only 
purpose of a package? 


A: Packages are important for 
three main reasons. First, they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they're all grouped 
into packages for specific kinds 
of functionality (like GUI or data 
structures or database stuff, etc.). 


Second, packages give you a name- 
scoping, to help prevent collisions 
if you and 12 other programmers 

in your company all decide to 

make a class with the same name. 
If you have a class named Set and 
someone else (including the Java 
API) has a class named Set, you 
need some way to tell the JVM 
which Set class you're trying to use. 


Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it. The details are in 
Appendix B. 


Q: OK, back to the name 
collision thing. How does a full 
name really help? What's to 
prevent two people from giving a 
class the same package name? 


A: Java has a naming 


convention that usually prevents 
this from happening, as long as 
developers adhere to it. 
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BULLET POINTS 
ArrayList is a class in the Java API. 


To put something into an ArrayList, use add(). 


To remove something from an ArrayList use 
remove(). 


To find out where something is (and if it is) in an 
ArrayList, use indexOf(). 


To find out if an ArrayList is empty, use isEmpty(). 


To get the size (number of elements) in an ArrayList, 
use the size() method. 


To get the length (number of elements) in a regular 
old array, remember, you use the length variable. 


An ArrayList resizes dynamically to whatever size 
is needed. It grows when objects are added, and it 
shrinks when objects are removed. 


You declare the type of the array using a type 
parameter, which is a type name in angle brackets. 
Example: ArrayList<Button> means the ArrayList 

will be able to hold only objects of type Button (or 
subclasses of Button as you'll learn in the next couple 
of chapters). 


Although an ArrayList holds objects and not primi- 
tives, the compiler will automatically “wrap” (and “un- 
wrap” when you take it out) a primitive into an Object 
and place that object in the ArrayList instead of the 
primitive. (More on this feature later in the book.) 


Classes are grouped into packages. 


Aclass has a full name, which is a combination of the 
package name and the class name. Class ArrayList is 
really java.util.ArrayList. 


To use a class in a package other than java.lang, you 
must tell Java the full name of the class. 


You can either use an import statement at the top of 
your source code, or you can type the full name every 
place you use the class in your code. 


there are_no e 
Dumb Questions 


+ Does import make my class 
bigger? Does it actually compile the 
imported class or package into my 
code? 


A: Perhaps you're a C program- 
mer? An import is not the same as an 
include. So the answer is no and no. 
Repeat after me:“an import statement 
saves you from typing.’ That's really it. 
You don't have to worry about your 
code becoming bloated, or slower, from 
too many imports. An import is simply 
the way you give Java the full name ofa 
class. 


+ OK, how come I never had to 
import the String class? Or System? 


A: Remember, you get the java.lang 
package sort of “pre-imported” for free. 
Because the classes in java.lang are so 
fundamental, you don’t have to use the 
full name. There is only one java.lang. 
String class and one java.lang.System 
class, and Java darn well knows where 
to find them. 


+ Dolhave to put my own classes 
into packages? How do! do that? Can 
| do that? 


A: In the real world (which you 
should try to avoid), yes, you will want 
to put your classes into packages. We'll 
get into that in detail in Appendix B. For 
now, we won't put our code examples in 
a package.* 


*But when_you look at the code in the repo 


(hitps://oreul. ly/hffava_3e_examples), you'll see 


we put the classes into packages. 
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Mak if threads cs | 
CIT Shiek © waito in | 
Roses are red, — 
apples are ripe 
if you don ‘timport 
you'll just have to type 
You must tel] J 


ceruent for the Class 
your source 
U have to t 
Where you 


Code is the 
ype the full 
USe jt! 


rwise, yo 


One more time, in the unlikely 
event that you don’t already 
have this down: 
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“Good to know there’s an ArrayList in the java. 
util package. But by myself, how would I have 
figured that out?” 


- Julia, 31, hand model 


How to discover the API 


Two things you want to know: 


What features are available in the 
library? (Which classes?) 


(2) How do you use these features? 
(Once you find a class, how do 
you know what it can do?) 


‘ay Browse a book 


@ Use the HTML API docs 


MODULE PACKAGE CLASS USE TREE PREVIEW NEW DEPRECATED INDEX HELP 


Java’ Platform, Standard Edition & Java Development Kit 
Version 17 API Specification 
This document is divided into two sections: 
Java SE 
The Java Platform, Standard Edition (Java SE) APIs define the core Java platform 
JDK 
The Java Development Kit (JDK) APIs are specific to the JDK and will not necessaz 


ET sve se | sox | otner motes 


in a Nutshell 


A DESKTOP QUICK REFERENCE Module Description 
java.base Defines the foundational APIs of the Java SE Platform. 
Benjamin J. Evans & David Flanagan java.compiler Defines the Language Model, Annotation Processing, a 
java.datatransfer Defines the API for transferring data between and witk 


https://docs.oracle.com/en/java/javase/17/docs/api/index.html 
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GD Browse a book 


Java 


in a Nutshell 


Flipping through a reference 
book 1s a good way to find out 
what’s in the Java library. You can 
easily stumble on to a package 

or class that looks useful just by 
browsing pages. 
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O'REILLY 


4 8. Working with Java Collections 


12h 3m remaining 


The List Interface 


A List is an ordered collection of objects. Each element of a list has a position in 
the list, and the List interface defines methods to query or set the element at a 
particular position, or index. In this respect, a List is like an array whose size 
changes as needed to accommodate the number of elements it contains. Unlike 


sets, lists allow duplicate elements. 


In addition to its index-based get() and set() methods, the List interface 
defines methods to add or remove an element at a particular index and also de- 
fines methods to return the index of the first or last occurrence of a particular 
value in the list. The add() and remove() methods inherited from 
Collection are defined to append to the list and to remove the first occurrence 
of the specified value from the list. The inherited addA11() appends all elements 
in the specified collection to the end of the list, and another version inserts the el- 
ements at a specified index. The retainAll() and removeAll() methods be- 
have as they do for any Collection, retaining or removing multiple occur- 


rences of the same value, if needed. 


The List interface does not define methods that operate on a range of list in- 
dexes. Instead, it defines a single subList() method that returns a List object 
that represents just the specified range of the original list. The sublist is backed by 
the parent list, and any changes made to the sublist are immediately visible in the 
parent list. Examples of subList() and the other basic List manipulation 


methods are shown here: 


// Create lists to work with 

List<String> 1 = new ArrayList<String>(Arrays.asList(args) ); 
List<String> words = Arrays.asList("hello", "world"); 
List<String> words2 = List.of("hello", "“world"); 


#% 9 
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using the Java AP! documentation 


2 Use the HTML API docs 


Java comes with a fabulous set of online docs called, strangely, the Java API. You (or your IDE) can also 
download the docs to have on your hard drive just in case your internet connection fails at the Worst Possible 
Moment. 


The API docs are the best reference for getting more details about what’s in a package, and what the classes 
and interfaces in the package provide (e.g., in terms of methods and functionality). 


The docs look different depending upon the version of Java you're using 
Make sure you're looking at the docs for your version of Java! 


Java 8 and earlier bors is 
. sya va V 
https://docs.oracle.com/javase/8/docs/api/index.html Ja Java 8 ‘A 
is 
Standard Ed. 8 ¥ 
All Classes All Profiles PREV NEXT FRAMES NO FRAMES 
Packi 
Seroll through the pack— ae Java™ Platform, Standard Edition 8 
anes and select one (eliek ecu API Specification 
t rest . 7 java.awt.color ; ; ; ; _ 
2 viet the | ist java.awt.datatransfer This document is the API specification for the Java™ Platform, Standard Edition. 
In the | f, java.awt.dnd ae 
k ower trame to java.awt.event See: Description 
only elasses from thal Fancesses | 
Package. ; Profiles 
AbstractAction 
AbstractAnnotationValueVisitor6 
AbstractannotationValueVisitor7 bes 
AbstractAnnotationValueVisitor8 * compact3 


AbstractBorder 
AbstractButton 
AbstractCellEditor 


AbstractChronology | Packages _ 
classes AbstractCollection 


\i) em 

ou! AbstractColorChooserPanel 

Corel {One s ( \ ek vt) AbstractDocument package et 

elect one a AbstractDocument.AttributeContext java.applet Provides the classes necessary to create an 
and s khe ss AbstractDocument.Content applet and the classes an applet uses to 
noose bv er AbstractDocument.ElementEdit communicate with its applet context. 
m V AbstractElementVisitor6 
\\ gM ne AbstractElementVisitor7 Java.awt Contains all of the classes for creating user 
AbstractElementVisitor8 interfaces and for painting graphics and 
fame: prasad ba images. 
stractinterruptibleChannel 
AbstractLayoutCache java.awt.color Provides classes for color spaces. 
AbstractLayoutCache.NodeDimensions 
AbstractList java.awt.datatransfer Provides interfaces and classes for 
AbstractListModel transferring data between and within 
AbstractMap applications. 
AbstractMap.SimpleEntry 
AbstractMap.SimplelmmutableEntry java.awt.dnd Drag and Drop is a direct manipulation 
AbstractMarshallerimp! aesture found in manv Graphical User 
You can navigate these docs: The main i : 
u g panel will show you the details of whatever 


* Top down: find a package you're 
interested in from the list in the 


-  Class-first: find the class you want 
to know more about in the list in 
the bottom left, and click it. 
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ing at. If 


ou select a class, it will show 
details of all the me 


use them. 


fou select a package, 
about that package Pe a ist 


top left and drill down. If 
an 


it will Give Summary in 
of the classes and interfaces. 


you a destription of the ¢lass, 
thods in the ¢lass, what they do, and how 


Pea look— 


ormation 


core Java packages like java.lang and java.util. - eco’ 
. ; | 1s act 
Slight! different URL to Jan? \ ec oR {ne 
the older dots Lamy yer son a 
* * 2s Ac 
https:/ /docs.oracle.com/en/java/javase/ 17 /docs/api/index.html A i 5 
gyre 
MODULE PACKAGE CLASS USE TREE PREVIEW NEW DEPRECATED INDEX HELP Java SE 17 & JDK 17 
SEARCH: [Q\search s—SsSCiSS 
i ; Sear, h 
ava atrorm, andar tion ava Developmen I KY 7 
Java: Platf Standard Edition & Java Devel t Kit fo, 
‘ ji Fi eit. a 
Version 17 API Specification els 10 med. 
S. 
This document is divided into two sections: Mm, 0, id, S/p, ‘ac k -) hod 
Java SE i¢ 4 ule y a 
The Java Platform, Standard Edition (Java SE) APIs define the core Java platform for general-purpose computing. a Ch, ec. % 5 Ping 
These APIs are in modules whose names start with java. dre Ou / Se, 
JDK S“9gest. doy, af 
The Java Development Kit (JDK) APIs are specific to the JDK and will not necessarily be available in all 1Op, Ss. 
implementations of the Java SE Platform. These APIs are in modules whose names start with jdk. 
PT inva se | sox | omer motes | 
Module Description 
java.base Defines the foundational APIs of the Java SE Platform. 
java.compiler Defines the Language Model, Annotation Processing, and Java Compiler APIs. 
java.datatransfer Defines the API for transferring data between and within applications. 
java.desktop Defines the AWT and Swing user interface toolkits, plus APIs for accessibility, audio, imaging, printing, 
The Jav8 
\sS and JavaBeans. 
glatkorn LL 7 th 1. th. 
en jeue inetrmant Tafinas camrinns that allaurarants ta ineteimant nracname minning an tha TUM 
w bor 
bat um \sted : 
wnto 3 0 veh av 
w \es whit dots: 
ok modes: ox th 
Ene rome FOB Oe 
Ly only wee bo the MODULE: DESCRIPTION | MODULES | PACKAGES | SERVICES SEARCH: |. Search 
’ os 
re ™ 
ie a\oase- afer boa bs pout Module java.base 
¥ r Gul we \ module java.base 
NNN, kor 3s well. Defines the foundational APIs of the Java SE Platform. 
4 gva.de Providers: 
y The JDK implementation of this module provides an implementation of the jrt file system provider to en 
and resource files in a run-time image. The jrt file system can be created by calling 
FileSystems .newFileSystem(URI.create("jrt:/")). 
You can navigate these docs: edule areph: 
a java.base 
* Top down: find a module that looks i 
like it covers the functionality you ina 
want, see its packages, and drill down since: 
from a package into its classes. When youve selected 
: Pack 
+ Search: Use the search in the 3 module, YX can ween 
top right to go directly to the see. a list of all | Exports | 7 
method, class, package, or module «1° packages and a Package Description 
its 4 hn a java.io Provides for system input and output through data streams, serializati 
you want to read about. yption ov W 
destv' Y r s for java.lang Provides classes that are fundamental to the design of the Java progra 
each package java.lang.annotation Provides library support for the Java programming language annotatic 
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Java 9 and later 


Java 9 introduced the Java Module System, which we’re not going to cover in this book. What you do need 
to know to understand the docs is that the JDK 1s now split into modules. These modules group together 
related packages. This can make it easier to find the classes that interest you, because they’re grouped by 
function. All of the classes we’ve covered in this book so far are in the java. base module; this contains 
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Using the class documentation 


Whichever version of the Java docs you’re using, they all have a similar layout for showing information 
about a specific class. This is where the juicy details are. 


Let’s say you were browsing through the reference book and found a class called ArrayList, in java.util. 
The book tells you a little about it, enough to know that this is indeed what you want to use, but you still 
need to know more about the methods. In the reference book, you'll find the method indexOf). But if all 
you knew is that there is a method called indexOf() that takes an object and returns the index (an int) of 
that object, you still need to know one crucial thing: what happens if the object is not in the ArrayList? 
Looking at the method signature alone won’t tell you how that works. But the API docs will (most of the 
time, anyway). The API docs tell you that the indexOf{) method returns a -1 if the object parameter is 
not in the ArrayList. So now we know we can use it both as a way to check if an object is even in the 
ArrayList, and to get its index at the same time, if the object was there. But without the API docs, we 
might have thought that the indexOf{) method would blow up if the object wasn’t in the ArrayList. 


— 
Java SE 17 & JDK 17 Make sure ; 


OVERVIEW MODULE PACKAGE USE TREE PREVIEW NEW DEPRECATED INDEX HELP 


A Ou 
DT FIELD | CONSTR | METHOD vom at he (4 
OCs toy th 
\ ox Constructor Summary Version 6 f if Sdme 
Ws va 
coe te OCP oF teal 
en e 
dne alt <n Ans Constructor Description _ Is Chan e 
if ava’ \etn ArrayList () Constructs an empty list with an initial capacity of ten. m Version to 
2) > by s¢ Version. 
ease ane” ArrayList(int initialCapacity) Constructs an empty list with the specified initial capacity. 
“Pal 


ArrayList (Collection<? extends E> c) Constructs a list containing the elements of the specified collection, in the 
order they are returned by the collection's iterator. 


Method Summary 
PT instance Methods | concrete Methods ris is were all Ere 
\ 
Modifier and Type Method Descrip sku 1s. You tan 
void add(int index, E element) Inserts t 00d ( the 
position i stroll hrovd} 
boolean add(E e) Appends i ods Lor a \ovie 
sa me  cliek on 
boolean addALL(int index, Collection<? extends Inserts all « summa 


E> c) 


collection in 
position. a me o 


boolean addALl(Collection<? extends E> c) Appends all « details: 
collection to \ 
they are retu 
Iterator. 
void clear() Removes all of the elements from this list. 
Object clone() Returns a shallow copy of this ArrayList 
instance. 
boolean contains (Object 0) Returns true if this list contains the specified 


element. 
In Chapters 11 and 12, you'll see how 


we use the API docs to figure out how 
to use the Java Libraries. 
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Code Magnets 


Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed below? NOTE: To do this exercise, you need 
one NEW piece of info—if you look in the API for 
ArrayList, you'll find a second add method that takes 
two arguments: 


a.remove (2) ; printList(a) ; 


add(int index, Object o) public static void printList (ArrayList<String> list) { 


It lets you specify to the 


ArrayList where to put the object you're adding. if (a, contains (" 


t " 
A.add("2 any , he ae i 


} 


a.add(2, "two"); 


public static void main (String[] args) { 


System.out.print (element + a) 


} 
System.out.println () ; 


(a.contains ("three")) { 
a.add("four") ; 


1 
public class ArrayListMagnet { 


if (a.indexOf("four") != 4) { 
a.add(4, "4.2"); 


import java. util.ArrayList; 


tring>() ; 


ArrayList<String> a = new ArrayLis 


File Edit Window Help Dance 


% java ArrayListMagnet 


zero one two three 
zero one three four 


a.add(3, "three") 
printList (a); 


zero one three four 
zero one three four 


————> Answers on page 165. youarehere> 163 


puzzle: crossword 


JavaCress 


How does this crossword puzzle help you learn 14 
Java? Well, all of the words are Java related 


(except one red herring). 


Hint: When in doubt, remember ArrayList. 


Across 

1. [can’t behave 

6. Or, in the courtroom 
7. Where it’s at baby 

9. A fork’s origin 

12. Grow an ArrayList 
13. Wholly massive 

14. Value copy 

16. Not an object 

17. An array on steroids 
19. Extent 


21. 19's counterpart 


22. Spanish geek snacks (Note: This has 15 


nothing to do with Java.) 
23. For lazy fingers 
24. Where packages roam 


More Hints: 


~~ e Burjew say “8h 
qsrAeuy YUIYL “OL 
BANIWHd “OL 8 “vy 
yspAeuy YUIYL “€ 
E2|QEPLUDAO SEUNM ‘7 
umoq 
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11 


20 27 


22 


23 


24 


Down 


2. Where the Java action is 


3. Addressable unit 


4. 2nd smallest 


5. Fractional default 


8. Library’s grandest 


10. Must be low density 


11. He's in there somewhere 


. Asif 


16. dearth method 


18. What shopping and arrays have in common 


20. Library acronym 


21. What goes around 


ssazijadde ysiueds—ener jnoge JON ‘ZZ 
quayxa sAeuy “LZ 

SAMI UOWUWOD ‘91 

ysrpAeuy YUIYL °Z 

SABLA g “1 

ssoly 


————> Answers on page 166. 
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Exercise Sotutions import java.util.ArrayList; 


public class ArrayListMagnet { 
public static void main(String[] args) { 
ArrayList<String> a = new ArrayList<String>() ; 


File Edit Window Help Dance 
.add(0, 


% java ArrayListMagnet 
zero one two three 


"zero" ) is 
a.add(1, "one"); 
a.add(2, "two"); 


zero one three four 
zero one three four 4. a.add(3, "three") ; 


zero one three four 4. printList (a) ; 


if (a.contains("three")) { 
a.add("four") ; 


} 
Code Ma nets a.remove (2) ; 
g 
(from page 163) printList (a) ; 
if (a.indexOf("four") != 4) { 
a.add(4, "4.2"); 
} 


printList (a) ; 


if (a.contains("two")) { 
a.add("2.2"); 


} 
printList (a) ; 


public static void printList(ArrayList<String> list) { 
for (String element : list) { 
System.out.print(element + " "); 
} 
System.out.println () ; 
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PIR|Iim| i/Tli lve} {s 
D E Ll |e 
~ O;B/JIE/C)T | INIDJE|X) 0 
JavaCress nD 
(from page 164) B 'P of |r El) t\y'c 
L "A|D|D "LiolN| 6 0 
6(E|T MC of T N 
id "Vv fA "| T 
"ala igialyiclils/TI Icy | s ia 
6 R "sjiizjel ft 
ra PLIE IN |4/T|# s| jm] IN 
P 0 u PTT ATPL AIS 
Pit M| PL OLRIT| JA T 
P PLILIBIR AR Y 


Write your OWN set of clues! Look at each word, and try to 
write your own clues. Try making them easier, or harder, or 


Ge sharpen your pencil 
ere yer 


Across more technical than the ones we have. 
Ts 

6. Down 
7. 2. 

9. 3. 

2. 4. 

13. 5. 

14. 8. 

16. 10. 

17. 11 

19, 15 

21. 16 

22. 18. 

23. 20. 

24. 21 
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7 inheritance and polymorphism 


We were underpaid, 


Better Livi ng in overworked coders ‘till we 


tried the Polymorphism Plan. But 


oO bjectvi il le thanks to the Plan, our future is 


bright. Yours can be too! 


Plan your programs with the future in mind. If there were a way to write 
Java code such that you could take more vacations, how much would it be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you'd 

be interested in? Then this is your lucky day. For just three easy payments of 60 minutes time, 
you can have all this. When you get on the Polymorphism Plan, you'll learn the 5 steps to bet- 
ter class design, the 3 tricks to polymorphism, the 8 ways to make flexible code, and if you act 
now—a bonus lesson on the 4 tips for exploiting inheritance. Don’t delay, an offer this good 
will give you the design freedom and programming flexibility you deserve. It’s quick, it’s easy, 


and it’s available now. Start today, and we'll throw in an extra level of abstraction! 
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the power of inheritance 


Chair Wars Revisited... 


Remember way back in Chapter 2, when Laura (pro- 
cedural programmer) and Brad (OO developer) were 
vying for the Aeron chair? Let’s look at a few pieces of 
that story to review the basics of inheritance. 


LAURA: You've got duplicated code! The rotate procedure is in 
all four Shape things. It’s a stupid design. You have to maintain 
four different rotate “methods.” How can that ever be good? 


BRAD: Oh, I guess you didn’t see the final design. Let me show 
you how OO inheritance works, Laura. 


I looked at what all four 
rotate() rotate() rotate() rotate() clas ges have in common. 
playSound() playSound() playSound() playSound() 4 
They’re Shapes, and they all rotate and 
playSound. Sol abstracted out the rotate() 
common features and put them into a playSound() 3) 
new class called Shape. — Then I linked the other 
four shape classes to 
superclass | rise the sa sian class 
playSound() 5 : . * 
in a relationship called 


inheritance. 
You can read this as “Square inherits from Shape”, 


“Circle inherits from Shape” and so on. | removed 
rotate() and playSound() from the other shapes, so now 
there’s only one copy to maintain. 


subclasses 


The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality. 
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What about the Amoeba rotate()? 


LAURA: Wasn’t that the whole problem here—that the Amoeba shape had a 
completely different rotate and playSound procedure? 


How can Amoeba do something different if it znherits its functionality 
from the Shape class? 


BRAD: That’s the last step. The Amoeba class overrides any 
methods of the Shape class that need specific amoeba behavior. Then 


at runtime, the JVM knows exactly which rotate() method to run when 
someone tells the Amoeba to rotate. 


superclass 
(more abstract) 


rotate() 


playSound() I made the Amoeba class override the 
rotate() and playSound() methods 

of the superclass Shape. Overriding 
just means that a subelass redefines 
one of its inherited methods when 


it needs to change or extend the 
behavior of that method. 


subclasses 
(more specific) 


NV (ee) (Coe) Cire 


rotate() 
/l amoeba-specific | 
// rotate code 


Overriding methods 
a : 


playSound() 
/| amoeba-specific 
// sound code 


io RAIN 

‘POWER 
How would you represent a house cat and a tiger, in an 
inheritance structure? Is a domestic cat a specialized 
version of a tiger? Which would be the subclass, and 


which would be the superclass? Or are they both 
subclasses to some other class? 


How would you design an inheritance structure? What 
methods would be overridden? 


Think about it. Before you turn the page. 
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Understanding Inheritance 


When you design with inheritance, you put common code in a 
class and then tell other more specific classes that the common 
(more abstract) class is their superclass. When one class inherits 
from another, the subclass inherits from the superclass. 


In Java, we say that the subclass extends the superclass. 

An inheritance relationship means that the subclass inherits the 
members of the superclass. When we say “members of a class,” 
we mean the instance variables and methods. For example if 
PantherMan is a subclass of SuperHero, the PantherMan class 
automatically inherits the instance variables and methods common 
to all superheroes including suit, tights, specialPower, 
useSpecialPower (), and so on. But the PantherMan sub- 
class can add new methods and instance variables of its 
own, and it can override the methods it inherits from the 
superclass SuperHero. 


superclass 


(more abstract] ae instance variables 
“3 specialPower (state, attributes) 


useSpecialPower() methods 
putOnSuit() (behavior) 


subclasses 
(more specific) 


2 PantherMan Overriding 
LA Z useSpecialPower() methods 


putOnSuit() — 


SS FriedEggMan doesn’t need any behavior that’s unique, 
pK so he doesn’t override any methods. ‘The methods and 
c-. variables in SuperHero are sufficient. 


PantherMan, though, has specific requirements for his suit 
and special powers, so uSeSpecialPower() and 
putOnSuit() are both overridden in the PantherMan 
class. 

Instance variables are not overridden because they 
don’t need to be. They don’t define any special behavior, so a 
subclass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 


An inheritance example: 


public 


boolean worksAtHospital; 


void treatPatient() { 


// 


inheritance and polymorphism 


IT inherited my 
procedures so I didn't 
bother with medical school. 
Relax, this won't hurt a bit. 
(now where did I put that 
power saw...) 


class Doctor { 


perform a checkup 


Overrides the inherited makesHouseCalls 
treatPatient() method | treatPatient () 


Adds one new method | makelncision() 


class FamilyDoctor extends Doctor { 


an makesHouseCalls; 


giveAdvice() { 
give homespun advice 


class Surgeon extends Doctor { 
treatPatient() { 


perform surgery 


makeIncision() { 
make incision (yikes!) 


; erp your pencil 
superclass IN 
How many instance variables does 


one instance variable Surgeon have?__ 


treatPatient () one method How many instance variables does 
FamilyDoctor have? 


How many methods does Doctor have? 


subclasses How many methods does Surgeon have? ____ 


FamilyDoctor How many methods does FamilyDoctor 


Adds one new have? 

instance variable . 

: ; Can a FamilyDoctor do treatPatient()?___—_ 
giveAdvice () Adds one new method 


Can a FamilyDoctor do makelncision()? 


—> Yours to solve. 
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designing for inheritance 


Let’s design the inheritance tree for 
an Animal simulation program 


Imagine you're asked to design a simulation program that lets the 
user throw a bunch of different animals into an environment to see 
what happens. We don’t have to code the thing now; we’re mostly 
interested in the design. 


We've been given a list of some of the animals that will be in 

the program, but not all. We know that each animal will be 
represented by an object and that the objects will move around in 
the environment, doing whatever it is that each particular type 1s 
programmed to do. 


And we want other programmers to be able to 
add new kinds of animals to the program at 
any time. 

First we have to figure out the common, abstract characteristics 


that all animals have, and build those characteristics into a class 
that all animal classes can extend. 


@ Look for objects that have common 
attributes and behaviors. 


What do these six types have in 
common? This helps you to abstract 
out behaviors. (step 2) 


How are these types related? This 
helps you to define the inheritance 
tree relationships (steps 4-5) 
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Using inheritance to avoid 
duplicating code in subclasses 


We have five instance variables: 
picture — the filename representing the JPEG of this animal. 


food — the type of food this animal eats. Right now, there can be 
only two values: meat or grass. 


hunger ~ an int representing the hunger level of the animal. It 
changes depending on when (and how much) the animal eats. 


boundaries — values representing the height and width of the 
“space” (for example, 640 x 480) that the animals will roam 
around in, 


location — the X and Y coordinates for where the animal is in 
the space. 


We have four methods: 


makeNoise() — behavior for when the animal is supposed to 
make noise. 


eat() — behavior for when the animal encounters its preferred 
food source, meat or grass. 


sleep() — behavior for when the animal is considered asleep. 


roam() — behavior for when the animal is not eating or sleeping 
(probably just wandering around waiting to bump into a food 
source or a boundary). 


Lion 


Hippo 


Tiger 


inheritance and polymorphism 


oO 


Design a class that represents 
the common state and behavior. 


These objects are all animals, so 
we'll make a common superclass 
called Animal. 


We'll put in methods and instance 
variables that all animals might 
need. 


picture 
food 
hunger 
boundaries 
location 


makeNoise() 
eat() 
sleep() 
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designing for inheritance 


Do all animals eat the same way? 


Assume that we all agree on one thing: the instance 
variables will work for all Animal types. A lion will have 
his own value for picture, food (we’re thinking meat), 
hunger, boundaries, and location. A hippo will have 
different values for his instance variables, but he’ll still 
have the same variables that the other Animal types 
have. Same with dog, tiger, and so on. But what about 
behavior? 


Which methods should we override? 


Does a lion make the same noise as a dog? Does a cat 
eat like a hippo? Maybe in your version, but in ours, 
eating and making noise are Animal-type-specific. We 
can’t figure out how to code those methods in such a way 
that they’d work for any animal. OK, that’s not true. We 
could write the makeNoise() method, for example, so 
that all it does is play a sound file defined in an instance 
variable for that type, but that’s not very specialized. 
Some animals might make different noises for different 
situations (like one for eating, and another 
when bumping into an enemy, etc.) 
I'm one bad*ss 


So just as with the Amoeba 
plant-eater. 


overriding the Shape class rotate() 
method, to get more amoeba-specific 
(in other words, unique) behavior, 
we'll have to do the same for our Animal 
subclasses. 


Decide if a subclass 

needs behaviors (method 
implementations) that are specific 
to that particular subclass type. 


Looking at the Animal class, 

we decide that eat() and 
makeNoise() should be overridden 
by the individual subclasses. 


In the dog community, 
barking is an important 
part of our cultural identity. 
We have a unique sound, and we 
want that diversity to be 
recognized and respected. 


picture 

food 

hunger 0 
i thods, eat 

boundaries We better override these two me’ se 

location and makeNoise(), so that each animal type 


makeNoise() 
eat() roam\/ Can stay generic. 
sleep() 
roam() 


174 chapter 7 


behavior for eatins and 


ine i cific 
<—~ nee paige it looks like sleep and 


Looking for more inheritance 
opportunities 


The class hierarchy is starting to shape up. We 

have each subclass override the makeNovse() and eat() 
methods so that there’s no mistaking a Dog bark from 
a Cat meow (quite insulting to both parties). And a 
Hippo won’t eat like a Lion. 


But perhaps there’s more we can do. We have to look 
at the subclasses of Animal and see if two or more 
can be grouped together in some way, and given code 
that’s common to only éhat new group. Wolf and Dog 
have similarities. So do Lion, Tiger, and Cat. 


Lion 


makeNoise() 
eat() 


Hippo 


Tiger 


inheritance and polymorphism 


o 


Look for more opportunities to use 

abstraction, by finding two or more 
subclasses that might need common 
behavior. 


We look at our classes and see 

that Wolf and Dog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 


picture 
food 
hunger 
boundaries 
location 


makeNoise() 
eat() 

sleep() 
roam() 


Wolf and 
Bathe the Ce are b oth Canines. 
Wain 


a that 


Wolf 


makeNoise() 
eat() 


Cat 


makeNoise() 


makeNoise() 
eat() 


makeNoise() eat() 
eat() 


makeNoise() 
eat() 
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designing for inheritance 


© Finish the class hierarchy 


Since animals already have an organizational 
hierarchy (the whole kingdom, genus, phylum 
thing), we can use the level that makes the most 
sense for class design. We'll use the biological 
“families” to organize the animals by making a 
Feline class and a Canine class. 


We decide that Canines could use a common 
roam() method, because they tend to move in 
packs. We also see that Felines could use a 
common roam() method, because they tend to 
avoid others of their own kind. We'll let Hippo 
continue to use its inherited roam() method— 
the generic one it gets from Animal. 


So we're done with the design for now; we'll 
come back to it later in the chapter. 


Feline 
roam() 

Hippo 
makeNoise() 
eat() 

Lion 
makeNoise() 
eat() 
Cat 
Tiger 
makeNoise() 
eat() 
makeNoise() 
eat() 
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picture 
food 
hunger 
boundaries 


location 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


eat() 


makeNoise() 
eat() 


makeNoise() 


inheritance and polymorphism 


Which method is called? 


The Wolf class has four methods. One inherited 
from Animal, one inherited from Canine (which 
is actually an overridden version of a method in 
class Animal), and two overridden in the Wolf 
class. When you create a Wolf object and assign 
it to a variable, you can use the dot operator 

on that reference variable to invoke all four 
methods. But which version of those methods 


gets called? sion 
makeNoise() 
eat() 
sleep() 

Make a new Wolf object Wolf w = new Wolf(); on 

Calls the version in Wolf w.makeNoise(); 

Calls the version in Canine w.roam(); Canine 

Calls the version in Wolf w.eat(); 

Calls the version in Animal w.sleep(); 


When you call a method on an object refer- 
ence, youre calling the most specific version 


of the method for that object type. makeNoise() 


eat() 


In other words, the lowest one wins! 


“Lowest” meaning lowest on the inheritance 
tree. Canine is lower than Animal, and Wolf 
is lower than Canine, so invoking a method 
on a reference to a Wolf object means the 
JVM starts looking first in the Wolf class. If 
the JVM doesn’t find a version of the method 
in the Wolf class, it starts walking back up the 
inheritance hierarchy until it finds a match. 
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practice designing an inheritance tree 


Designing an Inheritance Tree 


Class 
Clothing 


Superclasses 


Class Superclasses 


Musician 


Rock Star 


Bass Player 


Inheritance Table 


Subclasses 


Hint: not everything can be connected to something else. 
Hint: you're allowed to add to or change the classes listed. 


Q: You said that the JVM starts 
walking up the inheritance tree, 
starting at the class type you invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens if the JVM doesn’t ever find 
a match? 


178 chapter 7 


A: Good question! But you don’t 
have to worry about that. The compiler 
guarantees that a particular method is 
callable for a specific reference type, 
but it doesn't say (or care) from which 
class that method actually comes from 
at runtime. With the Wolf example, the 
compiler checks for a sleep() method 
but doesn’t care that sleep() is actually 
defined in (and inherited from) class 
Animal. Remember that if a class 
inherits a method, it has the method. 


subclasses 
(more specific) 


> 


superclass 
(more abstract) 


3 


Clothing 


Boxers 
Inheritance Class Diagram 


Draw an inheritance diagram here. 


—> Your’ to solve. 


Where the inherited method is defined 
(in other words, in which superclass 

it is defined) makes no difference to 
the compiler. But at runtime, the JVM 
will always pick the right one. And 
the right one means the most specific 
version for that particular object. 


Using IS-A and HAS-A 


Remember that when one class inherits 
from another, we say that the subclass 
extends the superclass. When you want to 
know if one thing should extend another, 
apply the IS-A test. 


Triangle IS-A Shape, yeah, that works. 
Cat IS-A Feline, that works too. 
Surgeon IS-A Doctor, still good. 


‘Tub extends Bathroom, sounds 
reasonable. 


Until you apply the IS-A test. 


To know if you've designed your types 
correctly, ask, “Does it make sense to say 
type X IS-A type Y?” If it doesn’t, you 
know there’s something wrong with the 
design, so if we apply the IS-A test, ‘Tub 
IS-A Bathroom is definitely false. 


What if we reverse it to Bathroom 
extends Tub? That still doesn’t work, 
Bathroom IS-A ‘Tub doesn’t work. 


‘Tub and Bathroom are related, but not 
through inheritance. Tub and Bathroom 
are joined by a HAS-A relationship. 
Does it make sense to say “Bathroom 
HAS-A Tub”? If yes, then it means that 
Bathroom has a Tub instance variable. In 
other words, Bathroom has a reference to 

a Tub, but Bathroom does not extend Tub 
and vice versa. 


Tub 
int size; 
Bathroom Bubbles b; 
Tub bathtub; 
Sink theSink; 


Bathroom HAS-A Tub and Tub HAS-A Bubbles. 
But nobody inherits from (extends) anybody else. 


inheritance and polymorphism 


Does it make sense to saya 
Tub IS-A Bathroom? Or a Bathroom 
IS-A Tub? Well, it doesn't to me. The 
relationship between my Tub and my 
Bathroom is HAS-A. Bathroom HAS-A 
Tub. That means Bathroom has a 


Tub instance variable. 


Bubbles 


int radius; 
int colorAmt; 
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exploiting the power of objects 
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But wait! There’s more! 


The IS-A test works anywhere in the inheritance tree. If your 


inheritance tree is well-designed, the IS-A test should make sense 


when you ask any subclass if it IS-A any of its supertypes. 


If class B extends class A, class B IS-A class A. 


This is true anywhere in the inheritance tree. If 
class C extends class B, class C passes the IS-A 
test for both B and A. 


Canine extends Animal 
Wolf extends Canine 


Wolf extends Animal 


Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 


Animal 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


roam() 


Wolf 


makeNoise() 
eat() 


With an inheritance tree like the one 
shown here, you’re always allowed to 
say “Wolf extends Animal” or 
“Wolf IS-A Animal.” It makes no 
difference if Animal is the superclass 
of the superclass of Wolf: In fact, as 
long as Animal is somewhere in 
the inheritance hierarchy above 
Wolf, Wolf IS-A Animal will 
always be true. 


The structure of the Animal 
inheritance tree says to the world: 


“Wolf IS-A Canine, so Wolf can 
do anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 


anything an Animal can do.” 


It makes no difference if Wolf 
overrides some of the methods in 
Animal or Canine. As far as the world 
(of other code) is concerned, a Wolf 
can do those four methods. How he 
does them, or in which class they’re 
overridden, makes no difference. A Wolf 
can makeNoise(), eat(), sleep(), and 
roam() because a Wolf extends from 
class Animal. 


How do you know if you've got 
your inheritance right? 


There’s obviously more to it than what we’ve 
covered so far, but we’ll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work we 
did in this chapter). 


For now, though, a good guideline 1s to use the IS-A 
test. If “X IS-A Y” makes sense, both classes (X 
and Y) should probably live in the same inheritance 
hierarchy. Chances are, they have the same or 
overlapping behaviors. 


Keep in mind that the 
inheritance IS-A relationship 
works in only one direction! 


Triangle IS-A Shape makes sense, so you can have 
Triangle extend Shape. 


But the reverse—Shape IS-A Triangle—does not 
make sense, so Shape should not extend Triangle. 
Remember that the IS-A relationship implies that if 
XIS-A Y, then X can do anything a Y can do (and 
possibly more). 


—> Yours to solve. 


Roses are 


inheritance and polymorphism 


Java is 


erp your pencil 
. IN 

Put a check next to the relationships that 
make sense. 


Oven extends Kitchen 


[-] Guitar extends Instrument 


Person extends Employee 


Ferrari extends Engine 


FriedEgg extends Food 


Beagle extends Pet 


Container extends Jar 


Metal extends Titanium 


GratefulDead extends Band 


Blonde extends Smart 


Beverage extends Martini 


Hint: apply the IS-A test 
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who inherits what 


there, are_no 


Dumb Questions 


: So we see how a subclass gets 
to inherit a superclass method, but 
what if the superclass wants to use 
the subclass version of the method? 


A: A superclass won't necessarily 
know about any of its subclasses. 

You might write a class and much 
later someone else comes along and 
extends it. But even if the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 


Q: In a subclass, what if | want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, | don’t want 
to completely replace the superclass 
version; | just want to add more stuff 
to it. 


A: You can do this! And it’s an 
important design feature. Think of the 
word “extends” as meaning “I want 

to extend the functionality of the 


You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need to 
“append” more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It’s like saying, “first go run the 
superclass version, then come back 
and finish with my own code...” 


there’s no sort of reverse or backward 
inheritance. Think about it, children 
inherit from parents, not the other way 
around. 


superclass.” 


public void roam() { 
super. roam() ; 
// my own roam stuff 


This calls the inherited version o 
are then comes back to do your 
own subclass—specirie code 


KR 


Who gets the Porsche, who gets the porcelain? 
(how to know what a subclass can 7% 
inherit from its superclass) ij 


A subclass inherits members of the 
superclass. Members include instance 
variables and methods, although later in 
this book we’ll look at other inherited members. A 
superclass can choose whether or not it wants a 
subclass to inherit a particular member by the level of 
access the particular member is given. 


There are four access levels that we’ll cover in this book. 
Moving from most restrictive to least, the four access 
levels are: 


private default 


a 


protected public 
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Access levels control who sees what, and are crucial 
to having well-designed, robust Java code. For now we’ll 
focus just on public and private. The rules are simple for 
those two: 


public members are inherited 
pak 
private members are not inherited 


When a subclass inherits a member, it is as if the 
subclass defined the member itself. In the Shape 
example, Square inherited the rotate () and 
playSound() methods and to the outside world (other 
code) the Square class simply fas a rotate () and 
playSound() method. 

The members of a class include the variables and 


methods defined in the class plus anything inherited 
from a superclass. 


Note: get more details about default and protected in 
Appendix B. 


When designing with inheritance, 
are you USING or abusing? 


Although some of the reasons behind these rules won’t be 
revealed until later in this book, for now, simply snowing a few 
rules will help you build a better inheritance design. 


DO use inheritance when one class is a more specific type of a 
superclass. Example: Willow is a more specific type of ‘Tree, so 
Willow extends Tree makes sense. 


DO consider inheritance when you have behavior 
(implemented code) that should be shared among multiple 
classes of the same general type. Example: Square, Circle, 
and Triangle all need to rotate and play sound, so putting 
that functionality in a superclass Shape might make sense and 
makes for easier maintenance and extensibility. Be aware, 
however, that while inheritance is one of the key features of 
object-oriented programming, it’s not necessarily the best way 
to achieve behavior reuse. It’ll get you started, and often it’s 
the right design choice, but design patterns will help you see 
other more subtle and flexible options. If you don’t know about 
design patterns, a good follow-on to this book would be Head 
First Design Patterns. 


DO NOT use inheritance just so that you can reuse code 
from another class, if the relationship between the superclass 
and subclass violate either of the above two rules. For example, 
imagine you wrote special printing code in the Animal class 
and now you need printing code in the Potato class. You might 
think about making Potato extend Animal so that Potato 
inherits the printing code. That makes no sense! A Potato is not 
an Animal! (So the printing code should be in a Printer class 
that all printable objects can take advantage of via a HAS-A 
relationship.) 


DO NOT use inheritance if the subclass and superclass 

do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS-A 
Beverage makes sense. Beverage IS-A Tea does not. 


-—— BULLET POINTS 


inheritance and polymorphism 


Asubclass extends a superclass. 


A subclass inherits all public instance 
variables and methods of the superclass, but 
does not inherit the private instance variables 
and methods of the superclass. 


Inherited methods can be overridden; instance 
variables cannot be overridden (although they 
can be redefined in the subclass, but that’s 
not the same thing, and there’s almost never a 
need to do it.) 


Use the IS-A test to verify that your 
inheritance hierarchy is valid. If X extends Y, 
then X IS-A Y must make sense. 


The IS-A relationship works in only one 
direction. A Hippo is an Animal, but not all 
Animals are Hippos. 


When a method is overridden in a subclass, 
and that method is invoked on an instance of 
the subclass, the overridden version of the 
method is called. (The lowest one wins.) 


If class B extends A, and C extends B, class 
B IS-A class A, and class C IS-A class B, and 
class C also IS-A class A. 
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exploiting the power of objects 


So what does all this 
inheritance really buy you? 


You get a lot of OO mileage by designing with 
inheritance. You can get rid of duplicate code by 
abstracting out the behavior common to a group 
of classes, and sticking that code in a superclass. 
That way, when you need to modify it, you have 
only one place to update, and the change ts magically 
reflected in all the classes that inhent that behavior 

Well, there’s no magic involved, but it zs pretty 
simple: make the change and compile the class 
again. That’s it. You don’t have to touch the 
subclasses! 


Just deliver the newly changed superclass, 
and all classes that extend it will 
automatically use the new version. 


A Java program is nothing but a pile of classes, 

so the subclasses don’t have to be recompiled in 
order to use the new version of the superclass. 

As long as the superclass doesn’t break anything 
for the subclass, everything’s fine. (We’ll discuss 
what the word “break” means in this context later 
in the book. For now, think of it as modifying 
something in the superclass that the subclass 

is depending on, like a particular method’s 
arguments, return type, method name, etc.) 
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You avoid duplicate 
code. 

Put common code in one place, and let 

the subclasses inherit that code froma 
superclass. When you want to change that 
behavior, you have to modify it in only 
one place, and everybody else (i.e., all the 
subclasses) sees the change. 


You define a common 
protocol for a group of 
classes. 


Um, what 
the heck does 
THAT mean? 


Inheritance lets you guarantee that 
all classes grouped under a certain 


supertype have all the methods that 


the supertype has* 


In other words, you define a common protocol for a 
set of classes related through inheritance. 


When you define methods in a superclass that can be inher- 
ited by subclasses, you’re announcing a kind of protocol to 
other code that says, “All my subtypes (1.e., subclasses) can 
do these things, with these methods that look like this...” 


In other words, you establish a contract. 


Class Animal establishes a common protocol for all Animal 
subtypes: 


You're felling, the world that 
oe a Animal can do these ‘vou 
sie f includes the method 

ings: That inclu 
roam) d veturn types: 


roam() arguments an 


And remember, when we say any Animal, we mean Animal 
and any class that extends from Animal. That again means, any 
class that has Animal somewhere above it in the inheritance hierarchy. 


But we’re not even at the really cool part yet, because we 
saved the best—polymorphism—for last. 


When you define a supertype for a group of classes, any 
subclass of that supertype can be substituted where the supertype 1s 
expected. 


Say, what? 


Don’t worry, we’re nowhere near done explaining it. Two 
pages from now, you'll be an expert. 


*When we say “all the methods,” we mean “all the inheritable methods,” which 
for now actually means “all the public methods,” although later we'll refine that 
definition a bit more. 


inheritance and polymorphism 


And I care because... 


You get to take advantage of 
polymorphism. 


Which matters to me 
because... 


You get to refer to a subclass object 
using a reference declared as the super- 


type. 


And that means to me... 


You get to write really flexible code. 
Code that's cleaner (more efficient, 
simpler). Code that's not just easier to 
develop, but also much, much easier to 
extend, in ways you never imagined at 
the time you originally wrote your code. 


That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 


You'll see how it works on the next page. 


We don't know about you, but 
personally, we find the whole 
tropical vacation thing 
particularly motivating. 
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the way polymorphism works 


To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 
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The 3 steps of object 
declaration and assignment 


1 2 
3 


SG 8 Eee 
Dog myDog = new Dog(); 


Declare a reference 
variable 


Dog myDog = new Dog() ; 


Tells the JVM to allocate space for a ref- 
erence variable. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 


2) Create an object 


Dog myDog = new Dog(); 


Dog 


Tells the JVM to allocate space for 
anew Dog object on the garbage 
collectible heap. 


Dog object 


Link the object 
and the reference 


Dog myDog = new Dog(); 


Assigns the new Dog to the refer- 
ence variable myDog. In other 
words, program the remote control. 


Dog object 


inheritance and polymorphism 


The important point is that the 
reference type AND the object 
type are the same. 


In this example, both are Dog. 


20g ob\e 


These two are the same type. The reference 
variable type is declared as Dog, and the object 
is created as new Dog(). 


But with polymorphism, the 
reference type and the object 
type can be different. 


Animal myDog = new Dog(); 


Animal 
Animal 


These two are NOT the same type. The 
veference variable type is declared as Animal, 
but the object is created as new Dog(). 
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polymorphism in action 


With polymorphism, the reference 
type can be a superclass of the 


actual object type. Uh...nope. 
Still not gettin’ it. 


When you declare a reference variable, any 
object that passes the IS-A test for the type 
of the reference can be assigned to that 


variable. In other words, anything that 
extends the declared reference variable type 
can be assigned to the reference variable. 
This lets you do things like make 
polymorphic arrays. 


ds) 
ther Yer 
Priva: \n . val: 
Detlare an acca Seecks ok Lyre Aw 
Ww 


ye an avv3y that 


Animal[] animals = new Animal[5]; 


OK, OK maybe an example will help. 


animals[0] = new Dog(); 
Saree ney ee eee But look what you get to do...You can put ANY subclass 
animals[2] = new Wolf(); € of Animal in the Animal array! 
animals[3] = new Hippo() ; 
animals[4] = new Lion() ; And here? , 
1 i hel e 
Pees d'etre for tnd eyrorrhie Part (the 
00) 

for (Animal animal : animals) { of the aie the a ei ° 

object does the iis methods, and coh Oe 


animal.eat() ; ee. 
On the first pass through the loop, ‘animal’ is a Dog, 


4 the Doo’s eat() method. On the next pass, 
seme Peron) Sere a Cat, 2 oh get the Cat’s eat) method. 


Came with roam(). 
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inheritance and polymorphism 


But wait! There’s more! 


You can have polymorphic 
arguments and return types. 
eee ——_ 


If you can declare a reference variable of a 
supertype, say, Animal, and assign a subclass 


object to it, say, Dog, think of how that might a 
work when the reference is an argument to a 4 “ 
method... 


class Vet { 


public void giveShot (Animal a) { [he 3! parame 
i er Can take ANY Animal 


// do horrible things to the Animal at mle as the argument. nd when th 
Is One divi ; . en e Ve 
// the other end of the ‘a’ parameter to makeNoiel Sd ing = inl 
really out there on the hea iP Netag 


a.makeNoise() ; makeNoise 


Q) method will na ats whose 


class PetOwner { 
The Vet's giveShot() method can take any 


Animal you give it. As long as the object 


Vet vet = new Vet() ; jou pass in as the argument is a subclass © 
pene it will work. 

Bed 60g > mew Dea) ae 

Hippo hippo = new Hippo() ; 


vet.giveShot (dog); @— Dog's makeNoise() runs 


-gi h hi ; ) 
vet.giveShot (hippo) an Hippo’s makeNoise() runs 


public void start() { 
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exploiting the power of polymorphism 


NOW I get it! If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I can pass in any subclass object at 

runtime. Cool. Because that also means I can write my 


code, go on vacation, and someone else can add new 
subclass types to the program and my methods will 
still work... (the only downside is I'm just making life 
easier for that idiot Jim). 


™ With polymorphism, you can write code that doesnt 
have to change when you introduce new subclass 
types into the program. 


Remember that Vet class? If you write that Vet class using 
arguments declared as type Ammal, your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their new Animal types 
extend class Animal. The Vet methods will still work, even though 
the Vet class was written without any knowledge of the new Animal 


subtypes the Vet will be working on. 


Bok. RAIN 

‘PQWER 
Why is polymorphism guaranteed to work this way? Why is 
it always safe to assume that any subclass type will have the 


methods you think you're calling on the superclass type (the 
superclass reference type you're using the dot operator on)? 
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there, are_no 


Dumb Questions 


Q: Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 


A: If you look in the Java API, 
you'll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes). You'll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn’t a hard limit (well, not one 
that you'd ever run into). 


: Hey, I just thought of 
something...if you don’t have access 
to the source code for a class but you 
want to change the way a method 
of that class works, could you use 
subclassing to do that? To extend 
the “bad” class and override the 
method with your own better code? 


A: Yep. That’s one cool feature 

of OO, and sometimes it saves you 
from having to rewrite the class 

from scratch or track down the 
programmer who hid the source code. 


Q: Can you extend any class? Or 
is it like class members where if the 
class is private you can’t inherit it... 


A: There’s no such thing as a 
private class, except in a very special 
case called an inner class, which we 
haven't looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 


The first is access control. Even 
though a class can’t be marked 
private, a class can be non-public 
(what you get if you don’t declare the 
class as public). A non-public class 
can be subclassed only by classes in 
the same package as the class. Classes 
in a different package won't be able to 
subclass (or even use, for that matter) 
the non-public class. 


The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it’s the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 


The third issue is that if a class has 
only private constructors (we'll 
look at constructors in Chapter 9), it 
can’t be subclassed. 


inheritance and polymorphism 


Q: Why would you ever want to 

make a final class? What advantage 
would there be in preventing a class 
from being subclassed? 


A: Typically, you won’t make 
your classes final. But if you need 


security—the security of knowing 
that the methods will always work the 
way that you wrote them (because 
they can’t be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class, for example, is final 
because, well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 


- Can you make a method final, 
without making the whole class 
final? 


A: If you want to protect a specific 
method from being overridden, mark 


the method with the final modifier. 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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overriding methods 


Keeping the contract: rules for overriding 


When you override a method from a superclass, you’re agreeing to fulfill the contract. 
The contract that says, for example, “I take no arguments and I return a boolean.” In 
other words, the arguments and return types of your overriding method must look to 

the outside world exactly like the overridden method in the superclass. 


The methods are the contract. 


If polymorphism is going to work, the Toaster’s version of the overridden method 
from Appliance has to work at runtime. Remember, the compiler looks at the 
reference type to decide whether you can call a particular method on that reference. 


Appliance appliance 
——_—_— 


Reference tyFe Object: type 


With an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method you’re invoking on an Appliance reference. But at 
runtime, the JVM does not look at the reference type (Appliance) but at the 


new Toaster () ; 


Appliance 


boolean turnOn() 


boolean turnOff() 


Toaster 


boolean turnOn(int level) 


actual Toaster object on the heap. This 1s oe on 
So if the compiler has already approved the method call, the only way it override, khe 
can work is if the overriding method has the same arguments and return Cant change an 
types. Otherwise, someone with an Appliance reference will call turnOn() as arguments method! 
a no-arg method, even though there’s a version in Toaster that takes an int. overriding This is actually a leas) 
Which one is called at runtime? The one in Appliance. In other words, the overLOAD, but. an 
turnOn(int level) method in Toaster is not an override! overR|DE. 
@ Arguments must be the same, and return 
types must be compatible. 
The contract of superclass defines how other code can use a method. 
Whatever the superclass takes as an argument, the subclass over- Appliance 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de- : 
: public boolean turnOn() 
clare either the same type or a subclass type. Remember, a subclass 
object is guaranteed to be able to do anything its superclass declares, public boolean turnOff() 
so it’s safe to return a subclass where the superclass is expected. 
@ The method can’t be less accessible. 
That means the access level must be the same, or friendlier. You 
can’t, for example, override a public method and make it private. 
What a shock that would be to the code invoking what it thinks (at NOT LEGAL! 
compile time) is a public method, if suddenly at runtime the JVM \eoal _\ Toaster 
slammed the door shut because the overriding version called at \t's not a 1e9 se You 
runtime is private! overide wel 3t- ; 
restrie ed tne & ‘ private boolean turnOn() 
So far we've learned about two access levels: private and public. tess leve Now ND 
The other two are in appendix B. There’s also another rule about 3 legal over LO Ay 
overriding related to exception handling, but we'll wait until Chap- because YU didn 


ter 13, Risky Behavior, to cover that. 


192 chapter 7 


Overloading a method 


Method overloading is nothing more than having two 
methods with the same name but different argument 
lists. Period. There’s no polymorphism involved with 
overloaded methods! 


Overloading lets you make multiple versions of a 
method, with different argument lists, for convenience 
to the callers. For example, if you have a method that 
takes only an int, the calling code has to convert, say, 
a double into an int before calling your method. But 
if you overloaded the method with another version 
that takes a double, then you’ve made things easier for 
the caller. You'll see more of this when we look into 
constructors in Chapter 9, Life and Death of an Object. 


Since an overloading method isn’t trying to fulfill 
the polymorphism contract defined by its superclass, 
overloaded methods have much more flexibility. 


@ The return types can be 
different. 


You're free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 


@ You can’t change ONLY the 
return type. 


If only the return type is different, it’s nota 
valid overload—the compiler will assume 
you’re trying to override the method. And even 
that won't be legal unless the return type is 

a subtype of the return type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the return type to anything. 


@) You can vary the access 
levels in any direction. 
You're free to overload a method with a method 
that’s more restrictive. It doesn’t matter, since the 


new method isn’t obligated to fulfill the contract of 
the overloaded method. 


inheritance and polymorphism 


An overloaded method 4s 
just a different method that 
happens to have the same 


method name. It has nothing 


to do with inheritance and 


polymorphism. An overloaded 
method is NOT the same as an 


overridden method. 


Legal examples of method 


overloading: 


public class Overloads { 


String uniqueID; 


public int addNums(int a, int b) { 


return a + b; 


} 


public double addNums (double a, double b) 
return a + b; 


} 


public void setUniquelID(String theID) 


// lots of validation code, and then: 
thelD; 


uniqueID = 


} 


public void setUniqueID(int ssNumber) 
String numString = "" + ssNumber; 
setUniqueID(numString) ; 


} 
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exercise: Mixed Messages 


A short Java program is listed below. One block of 
the program is missing! Your challenge is to match 
Mixed the candidate block of code (on the left), with the 


Messages output that you'd see if the block were inserted. 


Not all the lines of output will be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 


The program: 


class A { class C extends B { 
int ivar 7 void m3() { 
System.out.print("C's m3, " + (ivar + 6)); 
void m1() { } 
System.out.print("A's ml, ; } 
} 
void m2() { public class Mixed2 { 
System.out.print("A's m2, ; public static void main(String[] args) { 
} Aa 
void m3() { Bb 
System.out.print("A's m3, : Ce 
} Candidate code 
goes here 
class B extends A { (three lines) 
void m1() { 
System.out.print("B's m1, 
} 
} 


c.m2(); 


Code b.m1(); Output: 
candidates: = m3); } 


A’s ml, A’s m2, C’s m3, 6 


c.ml1(); B’s ml, A’s m2, A’s m3, 
c.m2(); 
c-m20; A's ml, B’s m2, A’s m3, 
a.m1(); B’s ml, A’s m2, C’s m3, 13 
pm? B’s ml, C’s m2, A’s m3, 
c.m3(); 

B’s ml, A’s m2, C’s m3, 6 
a2.m1() ; 
22.02; A’s ml, A’s m2, C’s m3, 13 
a2.m3(); 
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public class MonsterTestDrive { 


public static void main(String[] args) { 
Monster[] monsters = new Monster [3] ; 


monsters[0] = new Vampire () ; 
monsters [1] 


new Dragon () ; 
monsters[2] = new Monster () ; 


inheritance and polymorphism 


BE the Compiler 


Which of the A-B pairs of methods listed on the right, if 
inserted into the classes on the left, would compile and 
produce the output shown? (The A method inserted into 
class Monster, the B method inserted into class Vampire.) 


{ boolean frighten(int d) { 
System.out.println("arrrgh") ; 
® return true; 
} 
boolean frighten(int x) { 


‘B) System.out.printin("a bite?"); 
return false; 


for (int i = 0; i < monsters.length; i++) { } 


monsters [i] . frighten (i) ; 


class Monster { 


A 


} 


class Vampire extends Monster { 


5 


} 


class Dragon extends Monster { 
boolean frighten(int degree) { 


System.out.println ("breathe fire") ; 


return true; 


File Edit Window Help SaveYourself 


% java MonsterTestDrive 
a bite? 


breathe fire 
arrrgh 


2 boolean frighten(int x) { 
System.out.println("arrrgh") ; 
return true; 

} 

int frighten(int f) { 
System.out.printin("a bite?"); 
return 1; 


3 boolean frighten(int x) { 
vA) System.out.printin("arrrgh") ; 
return false; 
} 


boolean scare(int x) { 


System.out.printin("a bite?"); 
LB return true; 


} 


4 boolean frighten(int z) { 
System.out.println("arrrgh") ; 
return true; 

} 

boolean frighten(byte b) { 
System.out.printin("a bite?"); 
return true; 


> Answers on page 197. 
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puzzle: Pool Puzzle 


Poo] Puzzle 
\ Your job is to take code snippets from the pool and place them into 
the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don't be fooled—this one’s harder than it looks. 


by 
Z 


public class Rowboat { public class TestBoats { 
public rowTheBoat() { main(String[] args) { 
System.out.print("stroke natasha"); bl = new Boat(); 
} Sailboat b2 = new ()3 
} Rowboat = new Rowboat(); 
public class { 


b2.setLength (32); 
private int 


se 


bl. ()7 
void ( ){ b3. (); 
length = len; move (); 
} } 
public int getLength() { } 
; public class Boat { 
} public () { 
public move() { System.out.print(" ")i 
System. out.print(" ")i } 
\ } 


oltntaee drift drift hoist sail 


Rowboat 
Sailboat subclasses 


Boat 
Fain Testboats extends itt 
Hatten . hoist sail S 
continue F String rowTheBoat 
' int length move 
bI bieak _ j id setLength 
P int b3 vol bli 
int b2 . ; public 
b2 3 length int static stroke natasha 
len 


int b2 private 
— getLength 
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Exercise Solutions 


inheritance and polymorphism 


BE the Compiler (from page 195) 


Set 1 will work. 
Set 2 will not compile because of Vampire’s return 


type (int). 

The Vampire’s frighten() method (B) is not a legal 
override OR overload of Monster’s frighten() method. 
Changing ONLY the return type is not enough 

to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
override. (Remember, if you change ONLY the return 
type, it must be to a return type that is compatible 
with the superclass version's return type, and then it’s 
an override.) 


Sets 3 and 4 will compile but produce: 
arrrgh 

breathe fire 

arrrgh 


Remember, class Vampire did not override class 
Monster’s frighten() method. (The frighten() method 
in Vampire’s set 4 takes a byte, not an int.) 


Code 
candidates: 


RY, 
Q + 
Mixed 


Messages 
(from page 194) 


b.ml1(); 


c.m2(); } 
a.m3(); 


c.ml1(); 
c.m2(); } 
c.m3(); 


a.ml1(); 


b.m2(); 
c.m3(); 


a2.ml1(); 
22m) 4 
a2.m3(); 


Output: 


0 A's ml, A’s m2, C’s m3, 6 
B’s ml, A’s m2, A’s m3, 


A’s ml, B’s m2, A’s m3, 
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puzzle answers 


public class Rowboat extends Boat { 
public void rowTheBoat() { 
System.out.print("stroke natasha"); 


} 


} 
public class Boat { 
private int length ; 
public void setLength ( intlen ) { 
length = len; 


(from page 196) 


} 

public int getLength() { 
returnlength ; 

} 


public void move() { 
System.out.print( "drift "); 


public class TestBoats { 
public static void main(String[] args) { 
Boat b1 = new Boat(); 
Sailboat b2 = new Sailboat); 
Rowboat b3 = new Rowboat(); 
b2.setLength( 32); 
b1.move(); 
b3.move(); 
b2.move(); 


} 
} 


public class Sailboatextends Boat { 
public voidmove() { 
System.out.print( "hoist sail ") ; 


ole drift drift hoist sail 
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8 interfaces and abstract classes 


Serious Polymorphism 


Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn't even be possible without interfaces, so even if you don’t design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. You’ll wonder how you ever lived without them. What's an interface? 

It's a 100% abstract class. What’s an abstract class? It’s a class that can’t be instantiated. What's 
that good for? You'll see in just a few moments. But if you think about the end of the previous 
chapter, and how we used polymorphic arguments so that a single Vet method could take 
Animal subclasses of all types, well, that was just scratching the surface. Interfaces are the poly 


in polymorphism. The ab in abstract. The caffeine in Java. 


this is anewchapter 199 


designing with inheritance 


Vid we forget about something 
when we designed this? 


The class structure isn’t too bad. We’ve designed it so 
that duplicate code is kept to a minimum, and we’ve 
overridden the methods that we think should have 
subclass-specific implementations. We’ve made it nice 
and flexible from a polymorphic perspective, because 
we can design Animal-using programs with Animal 
arguments (and array declarations) so that any Animal 
subtype—including those we never imagined at 
the time we wrote our code—can be passed in and 
used at runtime. We’ve put the common protocol for 
all Animals (the four methods that we want the world 
to know all Animals have) in the Animal superclass, 
and we’re ready to start making new Lions and Tigers 
and Hippos. 


Feline 


roam() 


Lion 


makeNoise() 
eat() 


Cat 
Tiger 
makeNoise() 


eat() 


makeNoise() 
eat() 
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Hippo 


makeNoise() 
eat() 


picture 
food 
hunger 
boundaries 


location 


makeNoise() 
eat() 

sleep() 
roam() 


Canine 


eat() 


makeNoise() 
eat() 


makeNoise() 


interfaces and polymorphism 


We know we Can Say: 


Wolf aWolf = new Wolf (); 


A Wolf reference to a 


Gas 
Wolf object. Wolf a > an Nore abe’ 


These two are the same type. 


And we know we can Say: 


Animal aHippo = new Hippo(); 


Animal reference to a 


Hippo object. “4p <fex 
ee Animal Th > ae Po ob” 


These two are NOT the same type. 


But here’s where it gets weird: 


Animal anim = new Animal (); 
ae 


: > an Thimal coe” 
Animal . 


These two are the same type, but... 
what the heck does an Animal object look like? 


Animal reference to 
an Animal object. 
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when objects go bad 


What does a new Animal() object 
look like? 


seary objects 


What are the instance variable values? 


Some classes just should not be 


instantiated! 
It makes sense to create a Wolf object or a Hippo object in the first place (to use it as a polymorphic argument or 
or a Tiger object, but what exactly 7s an Animal object? return type, or to make a polymorphic array). 


is it? lor, si f legs... 5 a ; ; 
Wihaeshap Seal inal cole size nemepor ine When you're designing your class inheritance structure, 


Trying to create an object of type Animal is like a you have to decide which classes are abstract and which 
nightmare Star Trek™ transporter accident. are concrete. Concrete classes are those that are specific 
The one where somewhere in the beam-me-up process enough to be instantiated. A concrete class just means that 
something bad happened to the buffer. it's OK to make objects of that type. 

But how do we deal with this? We need an Animal Making a class abstract is easy—put the keyword 

class, for inheritance and polymorphism. But we want abstract before the class declaration: 


programmers to instantiate only the less abstract subclasses 
of class Animal, not Animal itself: We want Tiger objects 


and Lion objects, not Animal objects. abstract class Canine extends Animal { 
Fortunately, there’s a simple way to prevent a class from public void roam() { } 
ever being instantiated. In other words, to stop anyone } 


from saying “new” on that type. By marking the class as 
abstract, the compiler will stop any code, anywhere, 
from ever creating an instance of that type. 


You can still use that abstract type as a reference type. In 
fact, that’s a big part of why you have that abstract class 
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interfaces and polymorphism 


The compiler won't let you instantiate 
an abstract class 


An abstract class means that nobody can ever make a new instance 
of that class. You can still use that abstract class as a declared refer- 
ence type, for the purpose of polymorphism, but you don’t have to 
worry about somebody making objects of that type. The compiler 
guarantees it. 


abstract public class Canine extends Animal 


{ 


public void roam() { } 


} 


public class MakeCanine { 
public void go() { This is OX, ae per cae ek 
Canine Cc; 4 Le subelass 2) an Ke ss \s sostvatt- 


c new Dog () 


c = new Canine() ; r C 
_ < > Class Cay; ine j 
c.roam() ; Compiley- will N rked abst. 
or | et act, 
You do this. 


File Edit Window Help BeamMeUp 


javac MakeCanine.java 


MakeCanine.java:5: Canine is abstract; 


cannot be instantiated 


c = new Canine(); 
Aa 


An abstract class has virtually* no use, no value, no 
purpose in life, unless itis extended. 


With an abstract class, it’s the instances of a subclass of 
your abstract class that’s doing the work at runtime 


*There is an exception to this—an abstract class can have 
static members (see Chapter 10). 
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abstract and concrete classes 


Abstract vs. Concrete 


A class that’s not abstract is called 

a concrete class. In the Animal 
inheritance tree, if we make Animal, 
Canine, and Feline abstract, that 
leaves Hippo, Wolf, Dog, Tiger, Lion, 
and Cat as the concrete subclasses. 


Flip through the Java API and 
you'll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 

like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don’t make an instance of a 
generic Component and put it on the 
screen; you make a JButton. In other 
words, you instantiate only a concrete 
subclass of Gomponent, but never 
Component itself. 


ioe AUN 
POWER 


Hmmmm...do I 
feel like red or 
white tonight? 
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tonerete 


Hmmmm...the Camelot 
Vineyards 1997 Pinot 
Noir was a pretty 
decent year... 


abstract 


Cat 


tontrete 


concrete 


Tiger ) 
(&@ 


abstract 


Animal 


abstract 


concrete 


Abstract or concrete? 


How do you know when a class should be 
abstract? Wine is probably abstract. But what 
about Red and White? Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 


Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1997 
Pinot Noir is probably concrete no matter what. 
But how do you know for sure? 


Look at the Animal inheritance tree above. Do the 
choices we've made for which classes are abstract 
and which are concrete seem appropriate? 
Would you change anything about the Animal 
inheritance tree (other than adding more 
Animals, of course)? 


Abstract methods 


interfaces and polymorphism 


Besides classes, you can mark methods abstract, too. An abstract class 


means the class must be extended; an abstract method means the method 
must be overridden. You might decide that some (or all) behaviors in an 
abstract class don’t make any sense unless they’re implemented by a more 
specific subclass. In other words, you can’t think of any generic method 
implementation that could possibly be useful for subclasses. What would a 


generic eat() method look like? 


An abstract method has no body! 


Because you’ve already decided there isn’t any code that would make 
sense in the abstract method, you won’t put in a method body. So no curly 


braces— just end the declaration with a semicolon. 


public abstract void eat() ; 


No method body! 
End it with a sem 


If you declare an abstract method, you MUST 
mark the class abstract as well. You can’t have 
an abstract method in a non-abstract class. 


If you put even a single abstract method in a class, you have to make 
the class abstract. But you can mix both abstract and non-abstract 


methods in the abstract class. 


there, are no 


itolon. 


It really sucks to 
be an abstract method. 
You don't have a body. 


VA 


Dumb Questions 


+ What is the point of an abstract method? | thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 


A: Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put ina 
superclass. When it makes sense. And in an abstract class, it 
often doesn’t make sense, because you can’t come up with 
any generic code that subclasses would find useful. The 
point of an abstract method is that even though you haven't 
put in any actual method code, you've still defined part of 
the protocol for a group of subtypes (subclasses). 


Q: 


A: Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type. That way, you get 

to add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you'd have to 
change the Vet class, if it didn’t use Animal as its argument 
type for methods. You'd have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a...you get the idea. So with 
an abstract method, you're saying, “All subtypes of this type 
have THIS method” for the benefit of polymorphism. 


Which is good because... 
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you must implement abstract methods 
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You MUST implement all abstract methods 


Implementing an abstract 
method is just like 
overriding a method. 


I have wonderful news, 
mother. Joe finally implemented 
all his abstract methods! Now 
everything is working just the 
way we planned... 


Abstract methods don’t have a body; they exist solely for polymorphism. That means the 


first concrete class in the inheritance tree must implement all abstract methods. 


You can, however, pass the buck by being abstract yourself. If both Animal and Canine 


are abstract, for example, and both have abstract methods, class Ganine does not have to 


implement the abstract methods from Animal. But as soon as we get to the first concrete 


subclass, like Dog, that subclass must implement all of the abstract methods from both 


Animal and Canine. 


But remember that an abstract class can have both abstract and non-abstract methods, 


so Canine, for example, could implement an abstract method from Animal, so that Dog 
didn’t have to. But if Canine says nothing about the abstract methods from Animal, Dog 
has to implement all of Animal’s abstract methods. 


When we say “you must implement the abstract method,” that means you must provide 


a body, That means you must create a non-abstract method in your class with the same 


method signature (name and arguments) and a return type that is compatible with the 


declared return type of the abstract method. What you put zm that method is up to you. 
All Java cares about is that the method is there, in your concrete subclass. 
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Ge Sharpen your pencil 
ere yer P 


—> Yours to solve. 


Concrete 


golf course simulation 


satellite photo application 


interfaces and polymorphism 


Abstract versus Concrete classes 


Let’s put all this abstract rhetoric into some concrete use. In the middle 
column we've listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 
For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn't care about or distinguish between different 
types of trees. (There’s no one right answer; it depends on your design.) 


Sample class Abstract 


Tree tree nursery application 
House architect application 


Town 


Football Player coaching application 


Chair 


Customer 


Sales Order 


Book 


Store 


Supplier 


Golf Club 


Carburetor 


Oven 
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polymorphism examples 


Polymorphism in action 


Let’s say that we want to write our own kind of list class, one that will hold Dog 
objects, but pretend for a moment that we don’t know about the ArrayList class. 
For the first pass, we'll give it just an add() method. We'll use a simple Dog array 
(Dog{]) to keep the added Dog objects, and give it a length of 5. When we reach 
the limit of 5 Dog objects, you can still call the add() method, but it won’t do 
anything. If we’re not at the limit, the add() method puts the Dog in the array at 
the next available index position and then increments that next available index 


(nextIndex). 
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1Si 
x& 2. 


MyDogList 


Dog|] dogs 
int nextIndex 


add(Dog d) 
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public class MyDogList { Use a plain ol 


Building our own Dog-specific list 


(Perhaps the world’s worst attempt at making our 
own ArrayList kind of class, from scratch.) 


a Doo, arvay 


hind the stenes 
private Dog[] dogs = new Dog[5]; K be " 


private int nextIndex = 0; <—_ We'll increment this each time 
3 new Dog, is added. 


ublic void add (Dog 4) { 2 
a [f we've not already at the limit 


if (nextIndex < dogs.length) { of the dogs array, add the Dog 
: e. 
dogs[nextIndex] = d; and print 3 messag 
System.out.println ("Dog added at " + nextIndex) ; 
nextIndext+; — inére,, ent, to si 
i e 
} index to use us the next 


interfaces and polymorphism 


Uh-oh, now we need to keep Cats, too 


We have a few options here: 
1. Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 


2. Make a single class, DogAndCatLust, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog d). 
Another clunky solution. 


3. Make a heterogeneous AnimalList class that takes any kind of Animal subclass 

(since we know that if the spec changed to add Cats, sooner or later we’ll have some 
other kind of animal added as well). We like this option best, so let’s change our class to 
make it more generic, to take Animals instead of just Dogs. We’ve highlighted the key 
changes (the logic 1s the same, of course, but the type has changed from Dog to Animal 
everywhere in the code). 


Building our own Animal-specific list pot making, 2 


objects wee 
public class MyAnimalList { new ile sbiet , of ty es 
setsio new er) as annot srt bu 
? private Animal[] animals = new Animal[5]; (Remem of an abstract t yer 
private int nextIndex = 0; insta ake an array 2 ye 
MyAnimalList bia oie is HOLD that tyre 
public void add (Animal) a) { declare 
Animall] animals if (nextIndex < animals.length) { 
int nextIndex animals [nextIndex] = a; 
a System.out.println("Animal added at " + nextIndex) ; 
add(Animal a) nextIndex++; 
} 


public class AnimalTestDrive { 
public static void main(String[] args) { 
MyAnimalList list = new MyAnimalList() ; 
Dog dog = new Dog(); 
Cat cat = new Cat(); 
list.add (dog) ; 
list.add(cat) ; 


File Edit Window Help Harm 


java AnimalTestDrive 


Animal added at 0 


Animal added at 1 
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the ultimate superclass: Object 


What about non-Animals? Why not make 
a class generic enough to take anything? 


You know where this is heading. We want to change the type of the 
array, along with the add() method argument, to something above 
Animal. Something even more generic, more abstract than Animal. 
But how can we do it? We don’t have a superclass for Animal. 


Then again, maybe we do... 


Every class in Java extends 
class Object. 


Class Object is the mother of all classes; it’s the superclass of 
everything. 


Even if you take advantage of polymorphism, you still have to cre- 


ate a class with methods that take and return your polymorphic type. 


Without a common superclass for everything in Java, there’d be no 
way for the developers of Java to create classes with methods that 
could take your custom types...dypes they never knew about when they wrote 
the library class. 


So you were making subclasses of class Object from the very 
beginning and you didn’t even know it. Every class you write 
extends Object, without your ever having to say it. But you can 
think of it as though a class you write looks like this: 


public class Dog extends Object { } 


But wait a minute, Dog already extends something, Canine. That’s 
OK. The compiler will make Canine extend Object instead. Except 
Canine extends Animal. No problem, then the compiler will just 
make Animal extend Object. 


Any class that doesn’t explicitly extend another 
class, implicitly extends Object. 


So, since Dog extends Canine, it doesn’t directly extend Object 
(although it does extend it indirectly), and the same is true for 
Canine, but Animal does directly extend Object. 
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Object 


boolean equals() 
Class getClass() 
int hashCode() 

String toString() 


Animal doesn 


makeNoise() expat ae 
Wn) 
ae pal aie ical 


sleep() 
roam() 


Y a 
cubclass of byect- 


Canine 


makeNoise() 
eat() 


interfaces and polymorphism 


So what's in this ultra-super-megaclass Object? 


If you were Java, what behavior would you want every 
object to have? Hmmmm...let’s see...how about a 
method that lets you find out if one object is equal to 
another object? What about a method that can tell you 
the actual class type of that object? Maybe a method 
that gives you a hashcode for the object, so you can use 
the object in hashtables (we’ll talk about Java’s hashtables 
later). Oh, here’s a good one—a method that prints out a 
String message for that object. 


And what do you know? As if by magic, class Object 
does indeed have methods for those four things. That’s 
not all, though, but these are the ones we really care 
about. 


@ equals(Object o) 


Dog a 
Catc 


= new Dog(); 
= new Cat(); 
if (a.equals(c)) { 
System.out.println ("true") ; 
} else { 
System.out.println ("false") ; 


} 
File Edit Window Help Stop 


consi ered equal . 


false 


@ getClass() 


Cat c = new Cat(); 
System.out.println(c.getClass()); 


File Edit Window Help Faint 
Gives Yo 


% java TestObject 


class Cat 


u back the class that 
object was instantiated from. 


Object 
boolean equals() a of 
Class getClass() | just SOME of the methods 
int hashCode() class Object 
String toString() 


YourClassHere 


Every Class You write inherits 

all th 
methods of ¢lass Object. The fe 
youve written inhevited methods You 
didn’t even know You had. 


©) hashCode() 


Cat c = new Cat(); 
System. out.printlin(c.hashCode () ) ; 


File Edit Window Help Drop 


heode 
ants out 3 has 
jhe an oo abyect (Lor now) 
think of e gs a uniqve 


\D). 


% 


8202111 


% java TestObject rls he if two objects are 


@ toString() 


Cat c = new Cat(); 
System.out.println(c.toString()); 


File Edit Window Help LapselntoComa 


% java TestObject 


Cat@7d277£ 


ith 
i Chyring, message 
ene: the class and some 
See number WE rarely Care 


about 
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Object and abstract classes 


there, are_no 


Dumb Questions 


Q: Is class Object abstract? 


A: No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it’s 
got method implementation 
code that all classes can inherit 
and use out of the box, without 
having to override the methods. 


: Then can you override 
the methods in Object? 


A: Some of them. But some of 
them are marked final, which 
means you can’t override them. 
You're encouraged (strongly) to 
override hashCode(), equals(), 
and toString() in your own 
classes, and you'll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClass(), do things that must 
work in a specific, guaranteed 
way. 
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Q: HOW can you let 
somebody make an Object 


object? Isn’t that just as weird 
as making an Animal object? 


A: Good question! Why is 

it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 


Q: So is it fair to say that the 
main purpose for type Object 

is so that you can use it fora 
polymorphic argument and 
return type? 


A: The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we'll see those later in the 
book. 


Q: If it’s so good to use 
polymorphic types, why 
don’t you just make ALL your 
methods take and return type 
Object? 


A: Ahbhh...think about what 
would happen. For one thing, 
you would defeat the whole 
point of “type-safety,” one 

of Java's greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won't ask the wrong object 
to do something you meant to 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster) to cook itself. 

But the truth is, you don’t have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it’s 
referring to an instance of type 
Object. And that means the 
only methods you're allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 


Object o = new Ferrari() ; 
o.goFast(); //Not legal! 


You wouldn't even make it past 
the compiler. 


Because Java is a strongly typed 
language, the compiler checks 
to make sure that you're calling 
a method on an object that’s 
actually capable of responding. 
In other words, you can calla 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We'll cover this in much greater 
detail a little later, so don’t worry 
if the picture isn’t crystal clear. 


interfaces and polymorphism 


Using polymorphic references of type Object has a price... 


Before you run off and start using type Object for all your ultra-flexible argument and return types, 
you need to consider a little issue of using type Object as a reference. And keep in mind that we’re not 
talking about making instances of type Object; we’re talking about making instances of some other 
type, but using a reference of type Object. 
When you put an object into an ArrayList<Dog>, it goes in as a Dog and comes out as a Dog: 
Make an AyrayList de- ks 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog>() i Claved to hold Dog objet ; 
Dog aDog = new Dog();<— ee Doo to th list £ : 

a Add the 04 e Wst- Do re erence vVari-— 
7 Assign the Dea Crom the list to a new 09, 


hod declares 2 Dog 
7 7 Coot vi oe though the get) met 
Dog d = myDogArrayList.get (0); €— tee hie one es ee Noid Dep 


myDogArrayList.add(aDog 


But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList that 


will literally take any kind of Object, you declare it like this: 

- Make an AvrayList, declared 
, : to hold any type of Object: 
ArrayList<Object> myDogArrayList = new ArrayList<Object>() ; = 


Dog aDog = new Dog(); <— Make a Dos, eu two steps are the same as the 


myDogArrayList.add(aDog); e—fhdd the Dog to the list- \last example.) 


But what happens when you try to get the Dog object and assign it to a Dog reference? 


NO!! Won't compile!! When you use ArrayList<Object>, the get() method 


Dog M7 progarrayList.get (0); etimns type Object. The ane knows only that the object inherits from 
Object (somewhere in its inheritance tree) but it doesn't know it's a Dog! 


Everything comes out of an ArrayList<Object> as a reference of type Object, 
regardless of what the actual object is or what the reference type was when you added the 
object to the list. 
The objects go IN 
as SoccerBall, Objects come out of 
Fish, Guitar, and an ArrayList<Object> 
acting like they’re 
| generic instances 


of class Object. The 
ArrayList<Object> Compiler cannot 
| | assume the object 


Car. 


But they come 
OUT as though 


they were of type 
Object. 


that comes out is of 
any type other than 
Object. 
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When a Dog loses its Dogness 


I don't know what you're 
talking about. Sit? Stay? 

bark? Hmmmm...I don't 
recall knowing those. 


When a Dog wont act like a Dog 


The problem with having everything treated © 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their true 

essence. The Dog appears to lose its dogness. Let’s see 
what happens when we pass a Dog to a method 
that returns a reference to the same Dog object, 


but declares the return type as type Object rather 
than Dog. 


public void go() { es e wont, : ne very s et 
Dog abog = new Dog); is ee Ye Oe 
BAD Dog sameDog = getObject (aDog) ; ee re ma vekerved Ome ek you assign 


m0 ; ion ! 
public Object getObject (Object o} { 
return 0; but as a return 
ame Do ae 
} We've returning 3 ee legal Note this is 
ie type of Objet . This ied sted works when You have an 
sn te eet athe than an AvvayList<Dog>- 


File Edit Window Help Remember 


The Compiler doesn't know that the 
thing returned from the method is 
found : java.lang.Object actually a Dog, so it wont let you 

i assign it to a Dog, reference. (You'll 
required: Dog ; 

; see why on the next page- 
Dog sameDog = getObject(aDog) ; 

1 error A 


DogPolyTest.java:10: incompatible types 


public void go() { This works (although it may not be very use— 
Dog aDog = new Dog(); ful, as you'll see in a moment) because You Can 

600D Object sameDog = getObject (aDog) ; es assign ANYTHING toa reference of ty e 
© } Object, since every class passes the Ich test 
for Object. Every object in Java is an instance 
public Object getObject (Object o) { Al Object, because every class in Java has 

return o; ree at the top of its inheritance tree. 

} 
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Objects don't bark 


So now we know that when an object is 
referenced by a variable declared as type 
Object, it can’t be assigned to a variable 
declared with the actual object’s type. And 
we know that this can happen when a return 
type or argument is declared as type Object, 
as would be the case, for example, when the 
object is put into an ArrayList of type Object 
using ArrayList<Object>. But what are the 
implications of this? Is it a problem to have 
to use an Object reference variable to refer to 
a Dog object? Let’s try to call Dog methods 
on our Dog-That-Compiler-Thinks-Is-An- 
Object: 


Object o = 


int i = o.hashCode(); <—~ ~ jyo4 on AN 


al.get (index) ; 


interfaces and polymorphism 


Object 


When you get an object reference from 
an ArrayList<Object> (or any method 
that declares Object as the return type), 
it Comes back as a polymorphic reference 
type of Object. So you have an Object 
reference to (in this case) a Dog instante. 


hash- 
Class Objet® ee 


Won t compile! —» CFR: ¢—_ Can't do this!! The Object class has no idea what 


The compiler decides whether 
you can call a method based 


on the reference type, not the 
actual object type. 


Even if you know the object is capable (“...but 
it really ts a Dog, honest...”), the compiler 
sees it only as a generic Object. For all the 
compiler knows, you put a Button object 

out there. Or a Microwave object. Or some 
other thing that really doesn’t know how to 
bark. 

The compiler checks the class of the reference 
type—not the object type—to see if you can 
call a method using that reference. 


it means to bark(). Even though YOU know it’s 
veally a Dog at that index, the compiler doesn't. 


hashCode y 


Object 


The method you're calling on a 


equals() reference MUST be in the class of 
getClass() that reference type. Doesn't matter 
hashCode() 


what the actual object is. 
toString() 


o.hashCode () ; 


The “o” reference was declared as ope 
Object, So You Can tall methods only fi 
those methods are in class Object. 
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objects are Objects 


Object 


equals() 
getClass() 

hashCode() 
toString() 


Snowboard 


equals() 
getClass() 
hashCode() 
toString() 


turn() 
shred() 
getAir() 
loseControl() 
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He treats 


Snowboard inherits methods 
from superclass Object and 
adds four more. 


me like 


an Object. But I can do so 
much more...if only he'd see 
me for what I really am. 


Get in touch with your inner Object 


An object contains everything it inherits from each of its 


superclasses. That means every object—regardless of its actual 


class type—is also an instance of class Object. That means 


any object in Java can be treated not just as a Dog, Button, 


or Snowboard, but also as an Object. When you say new 
Snowboard (), you get a single object on the heap—a 
Snowboard object—but that Snowboard wraps itself around 


an inner core representing the Object (capital “O”) portion of 


itself. 


There is only ONE ol 


A single object 
on the eat. 


bject on the heap here. A Snowboard object. 


But it contains both the Snowboard ¢lass parts of itself and the 
Object class parts of itself. 


Polymorphism means 
“many forms.” 


You can treat a Snowboard as a 
Snowboard or as an Object. 


interfaces and polymorphism 


When you put 

an object in an 
ArrayList<Object>, you 
can treat it only as an 


Object, regardless of 
the type it was when 
you put it in. 


If a reference is like a remote control, the remote 
control takes on more and more buttons as you 
move down the inheritance tree. A remote control 
(reference) of type Object has only a few buttons— 
the buttons for the exposed methods of class Object. 
But a remote control of type Snowboard includes all 
the buttons from class Object, plus any new buttons 
(for new methods) of class Snowboard. The more 
specific the class, the more buttons it may have. 


When you get a 
reference from an 
ArrayList<Object>, the 
reference is always of 
type Object. 

Of course that’s not always true; a subclass might 
not add any new methods, but simply override the 
methods of its superclass. ‘The key point is that even 
if the object is of type Snowboard, an Object reference 
to the Snowboard object can’t see the Snowboard- 
specific methods. 


That means you get an 
Object remote control. 


Snowboard S_= new Snowboard () ; 


Object oO 


Snowboard 


The Snowboard remote control (vefer— 

ence) has more buttons than an Object 

remote control. The Snowboard remote 

can see the full Snowboardness of the Oo 

Snowboard object. [t ean access all the 

methods in Snowboard, in¢luding both The Object veference can see only the 

the inherited Object methods and the Object parts of the Snowboard o ject. It 

methods from class Snowboard. can access only the methods of class Object. 
It has fewer buttons than the Snowboard 


remote control. 


nw 
fewer methods here... Showbo ard ove” 


RK 
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casting objects 


Wait a minute...what good 


is a Dog if it comes out of an 
ArrayList<Object> and it can't do 
any Dog things? There's gotta be a 


Casting an object reference 
back to its real type. 


way to get the Dog back to a state 
of Dogness... 


GN 
og ob\’ 
Object 


T hope it doesn't hurt. And 
what's so wrong with staying 

an Object? OK, I can't fetch, 
sure, but I can give you a real 
nice hashcode. 


It’s really still a Dog object, but if you want to call Dog- 
specific methods, you need a reference declared as type 
Dog. If you’re sure* the object is really a Dog, you can 
make a new Dog reference to it by copying the Object 
reference, and forcing that copy to go into a Dog 
reference variable, using a cast (Dog). You can use the 
new Dog reference to call Dog methods. 


Object o = al.get(index) ; 
Dog d = (Dog) 07 ¢~gast the ; 
d.roam() ; 3 Dor, we know 


ett back to 
s there- 


Cast the so—ealled ‘Obj ect? (but 
we know he’s actually a Ds ) to 
type Des so that you ¢an test 
him like the Dog he really is. Dog 


*If you're not sure it's a Dog, you can use the instanceof 
operator to check. Because if you’re wrong when you do the 
cast, you'll get a ClassCastException at runtime and come to a 
grinding halt. 


if (o instanceof Dog) { 
Dog d = (Dog) 0; 
} 
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interfaces and polymorphism 


So now you’ve seen how much Java 
cares about the methods in the 
class of the reference variable. 

wer ee Eee 


You can call a method on an object only if 
the class of the reference variable has that 
method. 


Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 


When you write a class, you almost always expose some of the 
methods to code outside the class. To expose a method means 
you make a method accessible, usually by marking it public. 


Imagine this scenario: you’re writing code for a small business 
accounting program. A custom application for Simon’s Surf 
Shop. The good re-user that you are, you found an Account 
class that appears to meet your needs perfectly, Account 
according to its documentation, anyway. Each 


account instance represents an individual debit(double amt) 
customer’s account with the store. So there you 
are minding your own business invoking the credit{double amt) 
credit() and debit(/) methods on an Account object 


; double getBal 
when you realize you need to get a balance on acer 


an account. No problem—there’s a getBalance() 
method that should do nicely. 


Except...when you invoke the getBalance() method, the whole 
thing blows up at runtime. Forget the documentation, the 
class does not have that method. Yikes! 


But that won’t happen to you, because every time you use the 
dot operator on a reference (a.doStuff()), the compiler looks at 
the reference type (the type “a” was declared to be) and checks 
that class to guarantee the class has the method, and that the 
method does indeed take the argument you’re passing and 


return the kind of value you’re expecting to get back. 


Just remember that the compiler checks the class 
of the reference variable, not the class of the actual 
object at the other end of the reference. 
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modifying a class tree 


What if you need to change 
the contract? 


OK, pretend you’re a Dog. Your Dog class 
isn’t the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of your 
superclasses. 


True, your Dog class defines a contract. 
But not all of your contract. 


Everything in class Canine is part of your 
contract. 


Everything in class Animal is part of your 
contract. 


Everything in class Object is part of your 
contract. 


According to the IS-A test, you are each of those 
things—Canine, Animal, and Object. 


But what if the person who designed your class 
had in mind the Animal simulation program, and 
now he wants to use you (class Dog) for a Science 
Fair Tutorial on Animal objects. 


That’s OK, you’re probably reusable for that. 


But what if later he wants to use you for a Pet- 
Shop program? You don’t have any Pet behaviors. A 
Pet needs methods like beFivendly() and play(). 


OK, now pretend you’re the Dog class 
programmer. No problem, right? Just add some 
more methods to the Dog class. You won’t be 
breaking anyone else’s code by adding methods, 
since you aren’t touching the existing methods 
that someone else’s code might be calling on Dog 
objects. 


Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 
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OER AUN 
POWER 


Think about what YOU would do if YOU were the 


Dog class programmer and needed to modify the 


Dog so that it could do Pet things, too. We know 
that simply adding new Pet behaviors (methods) 
to the Dog class will work, and won't break anyone 
else's code. 


But...this is a PetShop program. It has more than 
just Dogs! And what if someone wants to use your 
Dog class for a program that has wild Dogs? What 
do you think your options might be, and without 
worrying about how Java handles things, just try 
to imagine how you’d like to solve the problem of 
modifying some of your Animal classes to include 
Pet behaviors. 


Stop right now and think about it, before you 
look at the next page where we begin to reveal 


everything.* 


*(Thus rendering the whole exercise completely useless, robbing 


you of your One Big Chance to burn some brain calories.) 


interfaces and polymorphism 


Let’s explore some design options 
for reusing some of our existing 
classes in a PetShop program 


On the next few pages, we’re going to walk through 
some possibilities. We’re not yet worried about whether 
Java can actually do what we come up with. We'll cross 
that bridge once we have a good idea of some of the 
trade-offs. 


@) Option one 
We take the easy path and put pet 
methods in class Animal. 


Pros: 


All the Animals will instantly inherit 
the pet behaviors. We won't have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses Animal 

created in the future will also get to 

take advantage of inheriting those 

methods. That way, class Animal can 

be used as the polymorphic type in 

any program that wants to treat the 

Animals as pets. Canine 


Cons: 


So...when was the last time you saw 
a Hippo at a pet shop? Lion? Wolf? 
Could be dangerous to give non- 
pets pet methods. 


Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 

and Cats tend to imple- 

ment pet behaviors 

VERY differently. 
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modifying existing classes 


@) Option two 
We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 


Pros: 


That would give us all the benefits of option one, but with- 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendly()). All Animal classes 
would have the method (because it's in class Animal), but 
because it's abstract, the non-pet Animal classes won't 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods “do-nothings.” 


Cons: 


Because the pet methods in the Animal class are all 

abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 

down the inheritance tree.) What a waste of time! 

You have to sit there and type in each and every 

pet method into each and every concrete non- 

pet class, and all future subclasses as well. 

And while this does solve the problem of "Feline | 
non-pets actually DOING pet things 

(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non-pet 

class would be announcing to the 
world that it, too, has those 

pet methods, even though 

the methods wouldn't 

actually DO anything 

when called. 


This approach doesn't 

look good at all. It just 

seems wrong to stuff 

everything into class Animal 

that more than one Animal type 
might need, UNLESS it applies to 
ALL Animal subclasses. 
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Animal 


Ask me to be friendly. 
No, seriously... ask me. 
T have the method. 


interfaces and polymorphism 


@) Option three 
Put the pet methods ONLY in the 
classes where they belong. 


Pros: 


No more worries about Hippos greeting you at the 

door or licking your face. The methods are where 

they belong, and ONLY where they belong. Dogs can 

implement the methods and Cats can implement the ONLY in the 
methods, but nobody else has to know about them. “4 Put the Pe ek mer L can ve PC 


sses 
primal ela Prim al. 


Cons: instead oF 


Two Big Problems with this approach. First off, you'd 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have 3 
to KNOW about the protocol. By protocol, we mean Animal 

the exact methods that we've decided all pets should 

have. The pet contract without anything to back it up. 

But what if one of the programmers gets it just a tiny 

bit wrong? Like, a method takes a String when it was 

supposed to take an int? Or they named it doFriendly() 

instead of beFriendly()? Since it isn't in a contract, Canine 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 


Feline 


And second, you don't get to use 
polymorphism for the pet methods. 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 

you can't use Animal 

as the polymorphic 

type now, because the 
compiler won't let you call 

a Pet method on an Animal 
reference (even if it's really a 
Dog object) because class Animal 
doesn't have the method. 


youarehere> 223 


multiple inheritance? 


So what we REALLY need is: 


« Away to have pet behavior in just the pet classes 


« Away to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right 

& Away to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class 


It looks like we need TWO 
superclasses at the top. 


ate itl owe 


WG 
we ane ale eee A 7 
ar bre FE as 


Animal 


The non—pet Animals don t 
have any inherited Pet 


stuff. 
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There’s just one problem with the “two superclasses” approach... 


interfaces and polymorphism 


It’s called “multiple inheritance,” 
and it can be a Really Bad Thing. 


That is, if it were possible to do in Java. 


But it isn't, because multiple inheritance has a problem 


bo 
er 
DBuener and aa 

C vk *irom Digits hod. 
ya ide ne DM ss a vate" 
ve t the “ instan 
inher! 


sable: 


known as The Deadly Diamond of Death. 


Deadly Diamond of Death 


DigitalRecorder 


A both 
Both 


CDBurner 


DVDBurner 


ComboDrive 


with 
Which burn() 
un) on the 


yariable is 


- 


ww? stant 


eid inheritance 


© Comb boDrin Ws You ¢all 


A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to deal 
with the potential ambiguities. And extra rules means extra work for 


you both in learning those rules and watching out for those “special 
cases.” Java is supposed to be s¢mple, with consistent rules that don’t 
blow up under some scenarios. So Java (unlike C++) protects you from 
having to think about the Deadly Diamond of Death. But that brings 
us back to the original problem! How do we handle the Animal/Pet thing? 
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interfaces 


Interface to the rescue! 


Java gives you a solution. An interface. Not a GUI interface, not the generic use of 
the word interface as in, ““That’s the public interface for the Button class API,” but 
the Java keyword interface. 


A Java interface solves your multiple inheritance problem by giving you much of 
the polymorphic benefits of multiple inheritance without the pain and suffering 
from the Deadly Diamond of Death (DDD). 


The way in which interfaces side-step the DDD is surprisingly simple: make all 
the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods must be implemented by the first concrete subclass), 
so at runtime the JVM isn’t confused about which of the two inherited versions it’s 
supposed to call. 


A Java interface is like a 
100% pure abstract class. 


7 Fri ly); e are 
abstract void beFriendly() ‘i csethods im san inter otf aE IS aa Pet 
abstract void play(); abstract s° o an L te ee) tne 
eee ‘ 
vic im? 
methods . 


To DEFINE an interface: 


public interface Pet {...} 


Use 4h, 
ay of * ie len interfaee” 


To IMPLEMENT an interface: 


public class Dog extends Canine implements Pet {... 


d “implements: followed by 


sme, Note that, when Yor 


Use the keywor 
Lerfate, You still get 


the interkace * 
implement an in 
; pee 9 Class: 
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interfaces and polymorphism 


Making and implementing 


the Pet interface 


Ww berfate! 
You $s 3ay Me W here- 
snstead 4d of class” 


public interface Pet { 
Oe see 
public abstract void beFriendly () ; 
public abstract void play (); 


om h Animal 
Pot Dag A Pet 


Interface m 
HA ein Hi shack are i implicit} 


: erton (in ie o rh “and | abstract 
style : i 
re nee Ype the words in, but we did h, 


ntorce it). 


i 


yaplements” 


You say 


1 __ followed by the name 
of the interface: 


public class Dog extends Canine implements Pet { 


public void beFriendly() {.. 


public void play() {..} 


public void roam() {...} 


public void eat() {.. 


there, are no 
mb Questions 


* Wait a minute, interfaces 
don’t really give you multiple 
inheritance, because you can’t put 
any implementation code in them. 
If all the methods are abstract, what 
does an interface really buy you? 


A: Well, actually...there are 
cases where interfaces can have 


implementation code (static and 
default methods, for example), but 
we're not going to go into them here. 


The main purpose of interfaces 

is polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
classes (or even abstract classes) as 
arguments and return types, you can 
pass anything that implements that 
interface. And with an interface, a class 
doesn’t have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 


.} hes These ave Just normal 


overriding eth 


So you get to treat an object by the role 
it plays, rather than by the class type 
from which it was instantiated. 


In fact, if you write your code using 
interfaces, you don't even have to give 
anyone a superclass to extend. You can 
just give them the interface and say, 
“Here, | don’t care what kind of class 
inheritance structure you come from, 
just implement this interface and you'll 
be good to go.” 
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interface polymorphism 


Classes from different inheritance trees 
can implement the same interface. 


Robot 


Pet 


~\\!b T 


_ RoboDog 


Animal 


When you use a class as a polymorphic type (like an 

array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type must be 
from the same inheritance tree. But not just anywhere in 
the inheritance tree; the objects must be from a class that 1s 
a subclass of the polymorphic type. An argument of type 
Canine can accept a Wolf and a Dog, but not a Cat or a 
Hippo. 


But when you use an interface as a polymorphic type 
(like an array of Pets), the objects can be from anywhere 

in the inheritance tree. The only requirement is that 

the objects are from a class that zmplements the interface. 
Allowing classes in different inheritance trees to implement 
a common interface 1s crucial in the Java API. Do 

you want an object to be able to save its state to a file? 
Implement the Serializable interface. Do you need objects 
to run their methods in a separate thread of execution? 
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Implement Runnable. You get the idea. You'll learn 
more about Serializable and Runnable in later chapters, 
but for now, remember that classes from any place in the 


inheritance tree might need to implement those interfaces. 
Nearly any class might want to be saveable or runnable. 


Better still, a class can implement 
multiple interfaces! 


A Dog object IS-A Canine, and IS-A Animal, and IS-A 
Object, all through inheritance. But a Dog IS-A Pet 
through interface implementation, and the Dog might 
implement other interfaces as well. You could say: 


public class Dog extends Animal implements 
Pet, Saveable, Paintable { ... } 


interfaces and polymorphism 


How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 


m Make aclass that doesn't extend anything 
(other than Object) when your new class doesn't 
pass the IS-A test for any other type. 


m Makea subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 


m Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 


m Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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using super 


Invoking the superclass version of a method ecion Ott 


there, are_no 


Dumb Questions 


Q: What if you make a concrete subclass 
and you need to override a method, but you 


want the behavior in the superclass version of 
the method? In other words, what if you don’t 


need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 


A: Ahhh...think about the meaning of the 
word extends. One area of good OO design looks 
at how to design concrete code that’s meant to 
be overridden. In other words, you write method 
code in, say, an abstract class, that does work 
that’s generic enough to support typical concrete 
implementations. But, the concrete code isn’t 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 

and extends it by adding the rest of the code. 

The keyword super lets you invoke a superclass 
version of an overridden method, from within the 
subclass. 


If method code inside a 
BuzzwordReport subtlass says: 
super. runReport () ; 


the runReport() method inside the 
superclass Report will run 


super.runReport(); 


A veference to the subclass object 
(BuzzwordReport) will always éall the 


bt 
abstract class Report { a bat a 


class BuzzwordsReport extends Report { 


me 


void runReport() { 
// set up report 

} 

void printReport() { 
// generic printing 


} 


ss version) 
back an 


do some suotlass— 


gpecivit stu 


void runReport() { tall super ch 
super. runReport () ; z then come 
buzzwordCompliance () ; 
printReport () ; 

} 


void buzzwordCompliance() {...} 


ages tne 
\ass met nod (overid 
wentlas version) 
AV 


runReport() 


buzzwordCompliance() superclass methods, 


intludin9 the overridden 
cunRepor 


% runReport() ¥ 
printReport() 


Report 


BuzzwordReport 


subelass version of an overridden method. 


That's polymorphism. But the subclass 
code can call super-runReport() to invoke 


the superclass version. 
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The super keyword is really a reference to the 
superclass portion of an object. When subclass 
code uses super, as in super-runReport(), the 
superclass version of the method will run. 


BULLET POINTS 


When you don’t want a class to be instantiated (in other words, you don't 
want anyone to make a new object of that class type), mark the class with the 
abstract keyword. 


An abstract class can have both abstract and non-abstract methods. 
If a class has even one abstract method, the class must be marked abstract. 


An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 


All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 


Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 


Methods can be declared with Object arguments and/or return types. 


You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual object type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 


When a method is invoked, it will use the object type's implementation of that 
method. 


A reference variable of type Object can’t be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 

Example: Dog d = (Dog) x.getObject (aDog) ; 


All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 


Multiple inheritance is not allowed in Java, because of the problems associated with 
the Deadly Diamond of Death. That means you can extend only one class (i.¢., you 
can have only one immediate superclass). 


Create an interface using the interface keyword instead of the word class. 


Implement an interface using the keyword implements. 
Example: Dog implements Pet 


Your class can implement multiple interfaces. 


Aclass that implements an interface must implement all the methods of the 
interface, except default and static methods (which we'll see in Chapter 12). 


To invoke the superclass version of a method from a subclass that’s overridden the 
method, use the super keyword. Example: super. runReport () ; 


interfaces and polymorphism 


there, are_no 


Dumb Questions 


Q: There’s still something 
strange here...you never 
explained how it is that 
ArrayList<Dog> gives back 
Dog references that don’t need 
to be cast. What's the special 
trick going on when you say 
ArrayList<Dog>? 


A: You're right for calling it a 
special trick. In fact, it is a special 


trick that ArrayList<Dog> gives 
back Dogs without you having 

to do any cast, since it looks like 
ArrayList methods don't know 
anything about Dogs, or any type 
besides Object. 


The short answer is that the 
compiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 

is a signal to the compiler that 
you want the compiler to let you 
put ONLY Dog objects in and to 
stop you if you try to add any 
other type to the list. And since 
the compiler stops you from 
adding anything but Dogs to the 
ArrayList, the compiler also knows 
that it’s safe to cast anything 

that comes out of that ArrayList 
to a Dog reference. In other 
words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it’s 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn't you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 


But there’s a lot more to this story, 
and we'll get into all the details in 
Chapter 11, Data Structures. 
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exercise: What’s the Picture? 


public 


public 


public 


public 


public 
public 


public 


public 
public 


public 


public 
public 
public 


public 


public 


Here's your chance to demonstrate your artistic abilities. On the left you'll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 


“implements” and a solid line for “extends.” 


What's the Picture 2 
ee 
interface) 
1. Foo 
interface Foo { } 
class Bar implements Foo { } 
2 wN 
interface Vinn { } : ! 
ee a eee 
abstract class Vout implements Vinn { } Bar 
abstract class Muffie implements Whuffie { } 
class Fluffie extends Muffie { } 3 
interface Whuffie { } 
class Zoop { } 4 
class Boop extends Zoop { } 
class Goop extends Boop { } 
class Gamma extends Delta implements Epsilon { } 
interface Epsilon { } 
interface Beta { } 5. 
class Alpha extends Gamma implements Beta { } key 
T extends 
class Delta { } = 
i implements 


—————> Answers on page 235. 
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Name \ class 
Name \ interface 


ame abstract class 


interfaces and polymorphism 


On the left you'll find sets of class diagrams. Your job is to 
turn these into valid Java declarations. We did number 1 for 
you (and it was a tough one). 


What's the Declaration ? 


Given: 
Click 1. public class Click { } 
i public class Clack extends Click { } 
Top 
2. 
2. 
Clack 
Tip 3 
Fee 
3, 
4. 
Foo 
4. 
Fi 
Bar 5. 
Zeta 
5. 
Baz 
Beta | 
Alpha -———— KEY ————__ 
T extends 
= : implements 
aN 
7 a oe 
[| Delta | . 
Clack interface 
———+> Answers on page 235. Cerca) abstract class 
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puzzle: Pool Puzzle 


Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out- 
put. You may use the same snippet more than once, 
and you won't need to use all the snippets. Your 
goal is to make a set of classes that will compile and 
run and produce the output listed. 


eee A public extends Clowns { 


} public static void main(String[] args) { 


abstract class Picasso implements { . 
i[0] = new 


return 7; LA] = Rey 
} i[2] = new 
} for (int x = 0; x < 3; xt+) { 


System.out.print1n ( 


class { } fe -getClass()); 


} Output 


return 5; Sjava 
} 5 class Acts 
} 7 class Clowns 
Of76 


Note: Each snippet 
from the pool can be 
used more than once! 


class 
Acts(); extends 


Nose(); interface i() 

Of76(); implements jx) 

Clowns(); ix] class 

Picasso(); 5 class 

7 class ay 
. . public int iMethod\() ; 7 public class ose 

ils {] i rah Nose[3]; public int iMethod{ } Of76 
Alas . public int iMethod() { i.iMethod(x) — Clowns 
Nose []i= new Nose(); — ublic int iMethod() {} i(x).iMethod[] Picasso 


Nose [] i = new Nose[3]; 


ix] .iMethod() 
i[x].iMethod[] 
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What's the Picture 2 (from page 232) 


a 
(Gnterface) 
Vinn 


tee 
Gnterface) 
WhuF fie 


a 


Fluffie 


Zoop 


Boop 


Goop 


ee 
(interface) 
Delta Epsilon 
So 
(interface) 
Gamma Beta 


ws 


8 LEP Wl 


Ai 


interfaces and polymorphism 


What's the Declaration ? (from page 233) 


2g. public abstract elass Top { } 
publie class Tip extends Top { } 


3, Public abstract class Fee { } 
public abstract class Fi extends Fee { } 


4 publie interface Foo { } 
public class Bar implements Foo { } 
public class Baz extends Bar { } 


5 public interface Zeta { } 
public class Alpha implements Zeta { } 
public interface Beta { } 
publie class Delta extends Alpha implements Beta { } 


key 


T extends 

ofS. 

i implements 
[ 

Name \ class 


Name | interface 
Name " abstract class 
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puzzle solution 


QR 


Poa] Puzzle 


(from page 234) 


interface Nose { 
public int iMethod() ; 


abstract class Picasso implements Nose { 
public int iMethod() { 


return 7; 


class Clowns extends Picasso { } 


class Acts extends Picasso { 
public int iMethod() { 


return 5; 
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public class Of76 extends Clowns { 
public static void main(String[] args) 
Nose[] i = new Nose [3]; 


i[0] new Acts(); 


ifl] = new Clowns(); 
i[2] = new Of76(); 


for (int x = 0; x < 3; x++) { 


System. out. print1n(i[x].iMethod() 


+" " + ifx].getClass()); 


Output 
Sjava Of76 
5 class Acts 


7 class Clowns 
7 class Of76 


{ 


9 constructors and garbage collection 


Life and Death 
of an Object 


.. then he said, 
“I can't feel my legs 

and I said “Joe! Stay with me 

Joe!" But it was...too late. The garbage 


\" 


collector came and...he was gone. Best 
object I ever had. Gone. 


Objects are born and objects die. You're in charge of an object's lifecycle. 

You decide when and how to construct it. You decide when to destroy it. Except you don't 
actually destroy the object yourself, you simply abandon it. But once it’s abandoned, the 
heartless Garbage Collector (gc) can vaporize it, reclaiming the memory that object was 
using. If you're gonna write Java, you're gonna create objects. Sooner or later, you're gonna 
have to let some of them go, or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they're alive, and how to keep or abandon them efficiently. 
That means we'll talk about the heap, the stack, scope, constructors, superclass constructors, 
null references, and more. Warning: this chapter contains material about object death that 


some may find disturbing. Best not to get too attached. 
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the stack and the heap 


The Stack and the Heap: where things live 


Before we can understand what really happens when you 
create an object, we have to step back a bit. We need to 
learn more about where everything lives (and for how 
long) in Java. That means we need to learn more about 
two areas of memory—the Stack and the Heap. When 

a JVM starts up, it gets a chunk of memory from the 
underlying OS and uses it to run your Java program. 
How much memory, and whether or not you can tweak 

it, is dependent on which version of the JVM (and on 
which platform) you’re running, But usually you won’t have 
any say in the matter. And with good programming, you 
probably won’t care (more on that a little later). 


The Stack 


Where method invocations 
and local variables live 


Instance Variables 


Instance variables are declared inside a class but not 
inside a method. They represent the “fields” that each 
individual object has (which can be filled with different 
values for each instance of the class). Instance variables 
live inside the object they belong to. 


public class Duck { 


utk \ has a “ize 
sable: 


int size; ~ Bvery D 


stan te var! 
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In Java, we (programmers) care about the area of memory 
where objects live (the heap) and the one where method 
invocations and local variables live (the stack). 


We know that all odyects live on the garbage-collectible 
heap, but we haven’t yet looked at where variables live. And 
where a variable lives depends on what kind of variable 

it is. And by “kind,” we don’t mean ype (1.e., primitive or 
object reference). The two kinds of variables whose lives 
we care about now are mstance variables and local variables. 
Local variables are also known as stack variables, which is a 
big clue for where they live. 


The Heap , “The 
Riso? ee Ca a yetkivle 


Where ALL objects live Garoa%s 
a Wear 


Local Variables 


Local variables are declared inside a method, including 
method parameters. They're temporary and live only as 
long as the method is on the stack (in other words, as long as 
the method has not reached the closing curly brace). 


public void foo(int x) { 
int i= x + 3; 


boolean b = 


true; 


Methods are stacked 


When you call a method, the method lands on the 
top of a call stack. That new thing that’s actually 
pushed onto the stack is the stack frame, and it 
holds the state of the method including which line 
of code is executing, and the values of all local 
variables. 


The method at the éop of the stack 1s always the 
currently running method for that stack (for now, 
assume there’s only one stack, but in Chapter 14, A 
Very Graphic Story, we'll add more.) A method stays 
on the stack until the method hits its closing curly 
brace (which means the method’s done). If method 
foo() calls method bar(), method bar() is stacked on 
top of method foo(). 


public void doStuff() { 
boolean b = true; 
go (4) ; 

} 


A stack 


constructors and gc 


A call stack with two methods 


Tor of the stack 
u— 


= Local variables 
a Cineluding 


Z Parameter x) 
Bottom of the stack 


The method on the top of the 
stack is always the currently 
executing method. 


scenario 


The code on the left is a snippet (we don’t care what the rest of the class 


looks like) with three methods. The first method (doStuff()) calls the second 


public void go(int x) { 
int. .z x + 24; 
crazy (); 
// imagine more code here 


} 


public void crazy() { 
char c ‘al; 


} 


Code from another 
class calls doStuff(), 
and doStuff() goes 
into a stack frame at 
the top of the stack. 
The boolean variable 
named “b" goes on 
the doStuff() stack 
frame. 


@ 


and go() is pushed 


frame. 


doStuff() calls go(), 


on top of the stack. 
Variables “x" and “z" 
are in the go() stack 


method (go()), and the second method calls the third (crazy()). Each method 
declares one local variable within the body of the method (4, z, and c), and 
method go() also declares a parameter variable (which means go() has two 
local variables, x and z). 


go() calls crazy(), @ crazy() completes, 
crazy() is now on the and its stack frame is 
top of the stack, popped off the stack. 


with variable “c" in 
the frame. 


Execution goes back 
to the go() method 
and picks up at the 
line following the call 
to crazy(). 


doStuflO Wr 
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object references on the stack 


What about local variables that are objects? 


a 
Remember, a non-primitive variable holds a reference to an object, 

not the object itself. You already know where objects live—on the 

heap. It doesn’t matter where they’re declared or created. If the 

local variable is a reference to an object, only the 

variable (the reference/remote control) goes on the ate 
stack. 


public class StackRef { 
public void foof() { 
barf (); 


; Qvck oe Yyeae 
public void barf() { 
Duck d = new Duck() ; 


No matt, Wi 
re Se nL the object 


: ™ Vs. as an ; ¥ declared (inside a 


} a Class), the oy yee nce variable of 


alnays goes on Phe heme” M85 


thereareno 
Dumb Questions 
+ One more time, WHY are we learning the 
whole stack/heap thing? How does this help me? 


_— BULLET POINTS 


Java has two areas of memory we care about: 


Do | really need to learn about it? 7 
the Stack and the Heap. 
A: = __ Instance variables are variables declared 
- Knowing the fundamentals of the Java inside a class but outside any method. 
Stack and Heap is crucial if you want to understand : ; —_ 
variable scope, object creation issues, memory = Local variables are variables declared inside a 
management, threads, and exception handling. method or method parameter. 


We cover threads and exception handling in later 
chapters. You do not need to know anything about 
how the Stack and Heap are implemented in any 
particular JVM and/or platform. Everything you 


need to know about the Stack and Heap is on this = Object reference variables work just like primi- 


page and the previous one. If you nail these pages, tive variables—if the reference is declared as a 
all the other topics that depend on your knowing local variable, it goes on the stack 
this stuff will go much, much, much easier. Once , , 


a All local variables live on the stack, in the 
frame corresponding to the method where the 
variables are declared. 


again, some day you will SO thank us for shoving s_ All objects live in the heap, regardless of 
Stacks and Heaps down your throat. whether the reference is a local or instance 
variable. 
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If local variables live on the stack, 
where do instance variables live? 
SS 


When you say new CellPhone(), Java has to make space on 
the Heap for that CellPhone. But how much space? Enough 
for the object, which means enough to house all of the 
object’s instance variables. That’s right, instance variables 
live on the Heap, iszde the object they belong to. 


Remember that the values of an object’s instance variables 
live inside the object. If the instance variables are all 
primitives, Java makes space for the instance variables 
based on the primitive type. An int needs 32 bits, a long 64 
bits, etc. Java doesn’t care about the value inside primitive 
variables; the bit-size of an int variable is the same (32 bits) 
whether the value of the int is 32,000,000 or 32. 


But what if the instance variables are objects? What if 
CellPhone HAS-A Antenna? In other words, CellPhone has 
a reference variable of type Antenna. 


When the new object has instance variables that are object 
references rather than primitives, the real question is: 
does the object need space for all of the objects it holds 
references to? The answer is, not exactly, No matter what, 
Java has to make space for the instance variable values. 
But remember that a reference variable value is not the 
whole olyect, but merely a remote control to the object. So 

if CellPhone has an instance variable declared as the 
non-primitive type Antenna, Java makes space within the 
CellPhone object only for the Antenna’s remote control (1.e., 
reference variable) but not the Antenna odyect. 


Well, then, when does the Antenna odject get space on the 
Heap? First we have to find out when the Antenna object 
itself is created. That depends on the instance variable 
declaration. If the instance variable is declared but no 
object is assigned to it, then only the space for the reference 
variable (the remote control) is created. 


private Antenna ant; 


No actual Antenna object is made on the heap unless or 
until the reference variable is assigned a new Antenna 
object. 


private Antenna ant = new Antenna() ; 


constructors and gc 
CellPhone object 


TAY, 


int long 


Object with two primitive instance variables. 
Space for the variables lives in the object. 


CellPhone object 


Object with one non—primitive instance variable— 
a reference to an Antenna object, but no actual 
Antenna object. This is what You get if you 
declare the variable but don't initialize it with 
an actual Antenna object. 


public class CellPhone { 
private Antenna ant; 


} 


CellPhone object Antenna object 


Object with one non—Pprimitive instante vari—- 
able, and the Antenna variable is assigned a new 
Antenna object. 


public class CellPhone { 
private Antenna ant = new Antenna() ; 


} 
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object creation 


The miracle of object creation 


Now that you know where variables and objects live, we can dive into the 
mysterious world of object creation. Remember the three steps of object 
declaration and assignment: declare a reference variable, create an object, 
and assign the object to the reference. 


But until now, step two—where a miracle occurs and the new object is 
“born’”—has remained a Big Mystery. Prepare to learn the facts of object 
life. Hope you’re not squeamish. 


Let's review the 3 steps of object 
declaration, creation and assignment: 


Declare a reference 
variable 


exerene 


ew 
Make @ ee: 3 class o ~~ Duck myDuck = new Duck() ; 
griddle a 


Seetate Yt 


(2) Create an object 
mei BENE ad Duck myDuck = new Duck() ; 
yates here: Duck object 
psig ne ne Link the object and 
ett Lhe the reference 
exeren Duck myDuck ©)new Duck () ; 


Duck object 


Duck reference 
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Are we calling a method named Duck()? 


Because it sure looks like it. ree talling 3 


| looks \ike we Duck, 


a method eee parentheses 
Duck myDuck = new Duck(); etavse 


No. 


We’re calling the Duck constructor. 


A constructor does look and feel a lot like a method, but it’s not a 
method. It’s got the code that runs when you say new. In other words, aconstructor has the 


the code that runs when you instantiate an object. code that runs when you 


The only way to invoke a constructor is with the keyword new instantiate an object. In 
followed by the class name. The JVM finds that class and invokes other words, the code that 


the constructor in that class. (OK, technically this isn’t the only way runs when you say new on 


a class type. 


to invoke a constructor. But it’s the only way to do it from owéside a 
constructor. You can call a constructor from within another constructor, 
with restrictions, but we’ll get into all that later in the chapter.) 


Every class you write has 
a constructor, even if you 
But where is the constructor? don’t write it yourself. 


If we didn’t write it, who did? 


You can write a constructor for your class (we’re about to do that), 
but if you don’t, the compiler writes one for you! 


Here’s what the compiler’s default constructor looks like: 
public Duck() { 


} 


Notice something missing? How is this 


different from a method? eis the $8 


am ) 
Name. Twat s mar 


wee 3S he class 


datery- 


public” Duck() { 


Where's th 
: ere 
is were a me irae type? If // constructor code goes here 
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constructing a new Duck 


Construct a Duck If it Quacks like a 


The key feature of a constructor is that it runs before constructor... 


the object can be assigned to a reference. That 
means you get a chance to step in and do things to 
get the object ready for use. In other words, before 
anyone can use the remote control for an object, the 
object has a chance to help construct itself: In our 
Duck constructor, we’re not doing anything useful, 
just demonstrating the sequence of events. 


public class Duck { 


public Duck() { 


System. out.printlin ("Quack") ; . 
} z P The constructor gives 


} . for code: you a chance to step into 
caer the middle of new. 


% java UseADuck 


public class UseADuck { 


public static void main (String[] args) { Quack 
Duck d = new Duck() ; 
} RR This calle 4, 


} Constructo, ¢ Duck 


—» Yours to solve. 


Increment a counter to track how many objects of this class type 
have been made. 


Assign runtime-specific state (data about what's happening NOW). 
Assign values to the object's important instance variables. 

Get and save a reference to the object that’s creating the new object. 
Add the object to an ArrayList. 


Ge sharpen your pencil 
ere yer P 


A constructor lets you jump into the middle 


of the object creation step—into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of the actions 
on the right might be useful in a Car class 


Create HAS-A objects. 


constructor, if the Car is part of a Racing ( idea here) 
your idea nere 


Game? Check off the ones that you came up 
with a scenario for. 
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lnitializing the state of a new Duck 


Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object’s instance 
variables. 


public Duck() { 
size = 34; 


} 


That’s all well and good when the Duck class developer knows how big 
the Duck object should be. But what if we want the programmer who 
is using Duck to decide how big a particular Duck should be? 


Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new Duck. 
How could you do it? 


Well, you could add a setSize() setter method to the class. But that 
leaves the Duck temporarily without a size* and forces the Duck user 
to write two statements—one to create the Duck, and one to call the 
setSize() method. The code below uses a setter method to set the 
initial size of the new Duck. 


public class Duck { ects 
int size; ~ \nstante varia 


public Duck() { 
System.out.println ("Quack") ; 


«Col 


public void setSize(int newSize) { 
size = newSize; _, Setter vn 
} 


ethod 


public class UseADuck { 


public static void main(String[] args) { 
Duck d = new Duck(); 


. b 
d.setSize(42); ¢—_ 'Salive a ies ee, here. The Due 


0.0 for numeric primitives, false for booleans, and 
null for references. 
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Dumb Questions 


: Why do you need to write a con- 
structor if the compiler writes one for you? 


A: If you need code to help initialize your 
object and get it ready for use, you'll have to 
write your own constructor. You might, for 
example, be dependent on input from the 
user before you can finish making the ob- 
ject ready. There’s another reason you might 
have to write a constructor, even if you 
don't need any constructor code yourself. It 
has to do with your superclass constructor, 
and we'll talk about that soon. 


+ How can you tell a constructor from 
a method? Can you also have a method 
that’s the same name as the class? 


A: Java lets you declare a method with 
the same name as your class. That doesn’t 
make it a constructor, though. The thing 
that separates a method from a construc- 
tor is the return type. Methods must have a 
return type, but constructors cannot have a 
return type. 


public Duck() { } Constructor 


public void Duck() { } Method 
T Return + pe 

The compiler will allow these methods but 

don’t do this. It's against normal naming 

conventions (methods start with a lower- 

case letter) but more importantly it’s super 

confusing. 


: Are constructors inherited? If you 
don’t provide a constructor but your 
superclass does, do you get the superclass 
constructor instead of the default? 


Nope. Constructors are not inherited. 
We'll look at that in just a few pages. 
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initializing object state 


Using the constructor to initialize 
important Duck state* 


If an object shouldn’t be used until one or more 
parts of its state (instance variables) have been 
initialized, don’t let anyone get hold of a Duck 
object until you’re finished initializing! It’s usually 
way too risky to let someone make—and get a 
reference to—a new Duck object that isn’t quite 
ready for use until that someone turns around and 
calls the setSize() method. How will the Duck user 
even know that he’s required to call the setter method 
after making the new Duck? 


Let the user make a new Duck 
and set the Duck's size all in 
one call. The call to new. 
The call to the Duck 
constructor. 


The best place to put initialization code is in the 
constructor. And all you need to do is make a 


constructor with arguments. ne 
rane 
public class Duck { 30 gn x kor 
int size; D ow pons 
Ww 
public Duck(int duckSize) { tice the argument value to set the 
System.out.printin ("Quack") ; ig astanee variable. We tould 
; thod 
size = duckSize; a have ¢alled the setSize me 
instead. 
System.out.println("size is " + size); 
} 
} 


public class UseADuck { 


public static void main (String[] args) { 


—, Duck d = new Duck (42) ; 
5 on } ( ) p 
as exe 98S a Value fo th 
ul or ener Le \. Constructo, “ 
Be) yl 
or ne ae one 
* g set "9 java UseADuck 
an 
nN 
skater Quack 


size is 42 


*Not to imply that not all Duck state is not unimportant. 
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Make it easy to make a Duck 
Be sure you have a no-arg constructor 


What happens if the Duck constructor takes an argument? Think 


about it. On the previous page, there’s only one Duck constructor—and 


it takes an int argument for the szze of the Duck. That might not be a 
big problem, but it does make it harder for a programmer to create a 
new Duck object, especially if the programmer doesn’t Anow what the 
size of a Duck should be. Wouldn’t it be helpful to have a default size 
for a Duck so that if the user doesn’t know an appropriate size, they 
can still make a Duck that works? 


Imagine that you want Duck users to have TWO options 
for making a Duck—one where they supply the Duck 
size (as the constructor argument) and one where they 
don’t specify a size and thus get your default Duck size. 


You can’t do this cleanly with just a single constructor. Remember, 

if a method (or constructor—same rules) has a parameter, you must 
pass an appropriate argument when you invoke that method or 
constructor. You can’t just say, “If someone doesn’t pass anything to 
the constructor, then use the default size” because they won’t even be 
able to compile without sending an int argument to the constructor 
call. You could do something clunky like this: 


public class Duck { = 
int size; ex value 


£ the parame “ae - 
public Duck(int newSize) { x52) Ys : herwise) ” 
if (newSize == 0) { 4 7 gexate * value *° 
size = 27; khe paronoT 3 very a0 
} else { ne 12© 
size = newSize; solution: 
} 


} 
} 
But that means the programmer making a new Duck object has to 
know that passing a “O” is the protocol for getting the default Duck 
size. Pretty ugly. What if the other programmer doesn’t know that? 
Or what if they really do want a zero-sized Duck? (Assuming a zero- 
sized Duck is allowed. If you don’t want zero-sized Duck objects, 
put validation code in the constructor to prevent it.) The point is, 
it might not always be possible to distinguish between a genuine “T 
want zero for the size” constructor argument and a “I’m sending 
zero so you'll give me the default size, whatever that is” constructor 
argument. 


constructors and gc 


You really want TWO ways to 
make a new Duck: 


public class Duck2 { 
int size; 


public Duck2() { 
// supply default size 
size = 27; 


} 


public Duck2(int duckSize) { 
// use duckSize parameter 
size = duckSize; 


} 


To make a Duck when you know the size: 
Duck2 d = new Duck2 (15) ; 


To make a Duck when you do not know 
the size: 


Duck2 d2 = new Duck2(); 


So this two-options-to-make-a-Duck idea 
needs two constructors. One that takes 
an int and one that doesn't. If you have 
more than one constructor in a class, 

it means you have overloaded 
constructors. 
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overloaded and default constructors 


Doesn't the compiler always 
make a no-arg constructor 
for you? \\o! 

a 


You might think that if you write only a 
constructor with arguments, the compiler 
will see that you don’t have a no-arg 
constructor and stick one in for you. But 
that’s not how it works. ‘The compiler gets 
involved with constructor-making only if you 
don’t say anything at all about constructors. 


If you write a constructor that 
takes arguments and you still 
want a no-arg constructor, 
you'll have to build the no-arg 
constructor yourself! 


As soon as you provide a constructor, ANY 
kind of constructor, the compiler backs off 
and says, “OK fair enough, looks like you’re 


in charge of constructors now.” 


If you have more than one 
constructor in a class, the 
constructors MUST have 
different argument lists. 


The argument list includes the order and 
types of the arguments. As long as they’re 
different, you can have more than one 
constructor. You can do this with methods as 
well, but we’ll get to that in another chapter. 
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OK, let's see here... “You 
have the right to your own 
constructor.” Makes sense. 


“If you cannot afford a constructor, 
one will be provided for you by the 
compiler." Good to know. 


Overloaded constructors means you have 
et ‘a 
more than one constructor in your class. 


To compile, each constructor must have a 
different argument list! 


The class below is legal because all five constructors have different 
argument lists. If you had two constructors that took only an int, for 
example, the class wouldn’t compile. What you name the parameter 
variable doesn’t count. It’s the variable type (int, Dog, etc.) and order 
that matters. You can have two constructors that have identical 
types, as long as the order is different. A constructor that takes 
a String followed by an int is not the same as one that takes an int 
followed by a String, 


public class Mushroom { 


When you know th 


constructors and gc 


Fie 
e Ve differe, om 
‘ans Five diff. "Struetoy, 
re 
nh 


make 
a new mushroo 


e@ size) but » hice 


~~ don't know if it’s magic 


public Mushroom(int size) { } 


dont know ary thing 


; ik When You x 
public Mushroom( ) { } When you know if it s magic or now 
public Mushroom(boolean isMagic) , } _ bt dent knew a 
These two ponte public Mushroom(boolean isMagic, int size) { } Mc eat 
‘firet order, © ( public Mushroom(int size, boolean isMagic) { } ee gs well 
it’s O 


+ the compiler know they were two di 


BULLET POINTS 


#*IL the arguments were the same ae shots 
erent things? 


= Instance variables live within the object they belongto,on 


If you want a no-arg constructor and you've already put 


the Heap. 


n_ Ifthe instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 


= Aconstructor is the code that runs when you say new on 
a Class type. 


= Aconstructor must have the same name as the class, and 
must not have a return type. 


= Youcan use a constructor to initialize the state (i.e., the 
instance variables) of the object being constructed. 


a __|f you don't put a constructor in your class, the compiler 
will put in a default constructor. 


m lhe default constructor is always a no-arg constructor. 


u___|f you put a constructor—any constructor—in your class, 
the compiler will not build the default constructor. 


in a constructor with arguments, you'll have to build the 
no-arg constructor yourself. 


Always provide a no-arg constructor if you can, to make it 
easy for programmers to make a working object. Supply 
default values. 


Overloaded constructors means you have more than one 
constructor in your class. 


Overloaded constructors must have different argument 
lists. 


You cannot have two constructors with the same 
argument lists. An argument list includes the order and 
type of arguments. 


Instance variables are assigned a default value, even 
when you don’t explicitly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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overloaded constructors 


G harpen your pencil 
IN Match the new Duck () call with the constructor 


that runs when that Duck is instantiated. We did 
the easy one to get you started. 


public class TestDuck { 


public static void main(String[] args) { 
int weight = 8; 
float density = 2.3F; 
String name = "Donald"; 
long[] feathers = {1, 2, 
boolean canFly = true; 
int airspeed = 22; 


3, 4, 5, 6}; 


Duck[] d = new Duck[7]; 


da[0] = new Duck(); 

d[1] = new Duck(density, weight) ; 

d[2] = new Duck(name, feathers) ; 

d[3] = new Duck (canFly) ; 

d[4] = new Duck(3.3F, airspeed) ; 

d[5] = new Duck(false) ; 

d[6] = new Duck(airspeed, density) ; 
} 


thereareno 
b Questions 


* Earlier you said that it’s good to have a no-argument 
constructor so that if people call the no-arg constructor, we 
can supply default values for the “missing” arguments. But 
aren’t there times when it’s impossible to come up with de- 
faults? Are there times when you should not have a no-arg 
constructor in your class? 


A: You're right. There are times when a no-arg construc- 
tor doesn’t make sense. You'll see this in the Java API—some 
classes don’t have a no-arg constructor. The Color class, for 
example, represents a...color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color instance, that instance is of 
a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of-Death Blue, Scandalous Red, etc.). 
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—-» Yours to solve. 


class Duck { 


private int kilos = 6; 
private float floatability = 2.1F; 
private String name = "Generic"; 
private long[] feathers = {1, 2, 3, 

4, 5, 6, 7}; 
private boolean canFly = true; 
private int maxSpeed = 25; 


public Duck() { 
System.out.println("type 1 duck") ; 
} 


public Duck(boolean fly) { 
canFly = fly; 
System.out.println("type 2 duck") ; 
} 


public Duck(String n, long[] f) { 
name = n; 
feathers £; 
System.out.println("type 3 duck") ; 
} 


public Duck(int w, float f) { 
kilos w; 
floatability = f; 
System.out.println("type 4 duck") ; 
} 


public Duck(float density, int max) { 
floatability = density; 
maxSpeed = max; 
System.out.println("type 5 duck") ; 
} 
} 


If you make a Color object, you must specify the color in 
some way. 
Color c new Color (3,45,200) ; 
(We're using three ints for RGB values here. We'll get into 
using Color later, in Chapter 15, Work on Your Swing.) Other- 
wise, what would you get? The Java API programmers could 
have decided that if you call a no-arg Color constructor 
you'll get a lovely shade of mauve. But good taste prevailed. 
If you try to make a Color without supplying an argument: 
Color c 


new Color(); 


File Edit Window Help StopBeingStupid 


cannot resolve symbol 
:constructor Color () 
location: class java.awt. 
Color 
Color c 


the compiler freaks 
out because it can’t 
find a matching no-arg 
constructor in the 
Color class. 


new Color() ; 
A 


1 error 


Nanoreview: four things to 
remember about constructors 


@) A constructor is the code that runs when 


@ 


*Doing all the Brain Power exercises has been shown to produce a 42% 
increase in neuron size. And you know what they say, “Big neurons...” 


somebody says new ona class type: 


Duck d = new Duck(); 
SSS es 


A constructor must have the same name 
as the class, and no return type: 


public Duck(int size) { } 


oe 


If you don't put a constructor in your class, 
the compiler puts in a default constructor. 
The default constructor is always a no-arg 
constructor. 


public Duck() { } 


You can have more than one constructor in your class, 
as long as the argument lists are different. Having 


more than one constructor in a class means you have 


overloaded constructors. 
pase Le iS) 


public Duck() { } 
public Duck(int size) { } 


public Duck(String name) { } 


public Duck(String name, int size) 


{ 


} 
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jo RAIN 
PQwWwER 
What about superclasses? 


When you make a Dog, 
should the Canine 
constructor run too? 


If the superclass is abstract, 
should it even havea 
constructor? 


We'll look at this on the next 
few pages, so stop now and 
think about the implications of 
constructors and superclasses.* 


there are no 4 
Dumb Questions 


: Doconstructors have to be public? 


A: No. Constructors can be public, pro- 
tected, private, or default (which means 
no access modifier at all). We'll look more at 
default access in appendix B. 


: How could a private constructor 
ever be useful? Nobody could ever call it, 
so nobody could ever make a new object! 


A: Not exactly right. Marking something 
private doesn’t mean nobody can access 
it; it just means that nobody outside the class 
can access it. Bet you're thinking Catch 

22. Only code from the same class as the 
class-with-private-constructor can make a 
new object from that class, but without first 
making an object, how do you ever get to 
run code from that class in the first place? 
How do you ever get to anything in that 
class? Patience grasshopper. We'll get there 
in the next chapter. 
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space for an object’s superclass parts 


Wait a minute...we never DID talk about 
superclasses and inheritance and how that all 
fits in with constructors 


Here’s where it gets fun. Remember in the previous chapter we looked at the Snowboard object 
wrapping around an inner core representing the Object portion of the Snowboard class? The 
Big Point there was that every object holds not just its own declared instance variables, but also 
everything from us superclasses (which, at a minimum, means class Object, since every class extends 


Object). 


So when an object is created (because somebody said new; there is no other way to create an 
object other than someone, somewhere saying new on the class type), the object gets space for 


all the instance variables, from all the way up the inheritance tree. Think about it for a moment... 


a superclass might have setter methods encapsulating a private variable. But that variable has to 
live somewhere. When an object is created, it’s almost as though multiple objects materialize—the 
object being new’d and one object per each superclass. Conceptually, though, it’s much better to 
think of it like the picture below, where the object being created has /ayers of itself representing 
each superclass. 


Object has instance variables 
encapsulated by access meth— 
ods. Those instance variables 
are created when any subélass is 
instantiated. (These aren't the 
REAL Object variables, but we 
don't care what they ave since 
they've encapsulated.) 


equals() 
getClass() 

hashCode() 
toString() 


A single 
objet on 
the heap 


Snowboard Snowboard also has instance 
Foo x variables of its own, so to make Snowboard 
Fooy a Snowboard object we need . 
inte space for the instance variables Sho oie’ 
Wbhoard 

turn() of both classes. 

hred 
ie: There is only ONE object on the heap here. A Snow- 
loseControl() board object. But it contains both the Snowboard 


parts of itself and the Object parts of itself. All 


instance variables from both classes have to be here. 
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The role of superclass constructors 


in an object’s life 


All the constructors in an object’s 
inheritance tree must run when you 
make a new object. 


Let that sink in. 


That means every superclass has a constructor 
(because every class has a constructor), and each 
constructor up the hierarchy runs at the time an 
object of a subclass is created. 


Saying new is a Big Deal. It starts the whole 
constructor chain reaction. And yes, even 
abstract classes have constructors. Although 
you can never say new on an abstract class, 
an abstract class is still a superclass, so its 
constructor runs when someone makes an 
instance of a concrete subclass. 


The superclass constructors run to build 

out the superclass parts of the object. 

Remember, a subclass might inherit methods 

that depend on superclass state (in other words, 
the value of instance variables in the superclass). 
For an object to be fully formed, all the superclass 
parts of itself must be fully formed, and that’s why the 
superclass constructor must run. All instance variables 
from every class in the inheritance tree have to be 
declared and initialized. Even if Animal has instance 
variables that Hippo doesn’t inherit (if the variables 
are private, for example), the Hippo still depends on 
the Animal methods that use those variables. 


When a constructor runs, it immediately calls its 
superclass constructor, all the way up the chain until 
you get to the class Object constructor. 


On the next few pages, you'll learn how superclass 
constructors are called, and how you can call them 
yourself. You'll also learn what to do if your superclass 
constructor has arguments! 
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Animal 


A single Hippo object on the heap 


A new Hippo object also IS-A Animal 
and IS-A Object. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 


This all happens in a process called 
Constructor Chaining. 
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Making a Hippo means making the 
Animal and Object parts too... 


public class Animal { 
public Animal() { 
System.out.println("Making an Animal") ; 


} 


public class Hippo extends Animal { 


public Hippo() { 
System.out.println("Making a Hippo") ; 


} 
} 


public class TestHippo { 


public static void main(String[] args) { 


System.out.println("Starting..."); 
Hippo h = new Hippo() ; 


} 
} 


Given the class hierarchy in the code above, we can step through the 


process of creating a new Hippo object. 


@) Code from another 
class calls new 


Hippo (), and the 
Hippo() constructor 
goes into a stack 
frame at the top of 
the stack. 


Hippo() invokes 

the superclass 
constructor, which 
pushes the Animal() 
constructor onto the 
top of the stack. 
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Ge Sharpen your pencil 
ere yr 


What's the real output? Given the 
code on the left, what prints out 
when you run TestHippo? A or B? 


(The answer is at the bottom of the page.) 


| File Edit_Window Help Swear 
%$ java TestHippo 
Starting... 
Making an Animal 


Making a Hippo 


% java TestHippo 
Starting... 


Making a Hippo 


Making an Animal 


©) Animal() invokes OQ) Object() completes, 
the superclass and its stack frame 
constructor, which is popped off the 


stack. Execution goes 
back to the Animal() 
constructor and 
picks up at the line 
following Animal's 

call to its superclass 
constructor. 


pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animal. 


"]SJ SAYSIUY JU} JOJONSUOD |BUY 84} S,}! 
4Nq ‘JSJIJ PAYOAUT SI JOJONIJSUOD ()oddiH ayL “Wy ‘9UO }SUy OYL 


How do you invoke a superclass constructor? 


You might think that somewhere in, say, a Duck constructor, if 
Duck extends Animal you’d call Animal(). But that’s not how it 
works: 


public class Duck extends Animal { 


int size; 


public Duck(int newSize) { 
—-, Animal () ; <— nol 


size = newSize; 


BAD! is j 
IS not. leg all/ 


The only way to call a superclass constructor is by calling super(). 
That’s right—super() calls the superclass constructor. 


What are the odds? 


public class Duck extends Animal { 


int size; 


public Duck(int newSize) { 
super(); <— you Just Call super() 


size = newSize; 


A call to super() in your constructor puts the superclass 
constructor on the top of the Stack. And what do you think that 
superclass constructor does? Calls its superclass constructor. And so it 
goes until the Object constructor is on the top of the Stack. Once 
Object() finishes, it’s popped off the Stack, and the next thing 
down the Stack (the subclass constructor that called Object() 

is now on top. That constructor finishes and so it goes until the 
original constructor is on the top of the Stack, where 7 can now 
finish. 
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And how is it that we’ve 
gotten away without 
calling super() before? 


You probably figured that out. 


Our good friend the compiler 
puts in a call to super() if you 
don't. 


So the compiler gets involved in 
constructor-making in two ways: 


@) If you don’t provide a constructor 
The compiler puts one in that looks like: 


public ClassName() { 
super () ; 


} 


@) If you do provide a constructor 
but you do not put in the call to 
super() 


The compiler will put a call to super() in 
each of your overloaded constructors.* 
The compiler-supplied call looks like: 


super (); 


It always looks like that. The compiler- 
inserted call to super() is always a no-arg 
call. If the superclass has overloaded 
constructors, only the no-arg constructor 
is called. 


*Unless the constructor calls another overloaded 
constructor (you'll see that in a few pages). 
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Can the child exist before 
the parents? 


Eewwww...that 


If you think of a superclass as the parent to the subclass child, you is SO creepy. There's 
can figure out which has to exist first. The superclass parts of an no way I could have been 
object have to be fully formed (completely built) before born before my parents. 


the subclass parts can be constructed. 
Remember, the subclass object might depend 
on things it inherits from the superclass, so it’s 


That's just wrong. 


important that those inherited things be finished. 
No way around it. The superclass constructor 
must finish before its subclass constructor. 


Look at the Stack series on page 254 again, and 
you can see that while the Hippo constructor 

is the first to be invoked (it’s the first thing on 
the Stack), it’s the /ast one to complete! Each 
subclass constructor immediately invokes its 
own superclass constructor, until the Object 
constructor is on the top of the Stack. Then 
Object’s constructor completes, and we 

bounce back down the Stack to Animal’s 
constructor. Only after Animal’s constructor 
completes do we finally come back down to finish the rest of the 
Hippo constructor. For that reason: 


The call to super() must be the first statement 
in each constructor!* 


Possible constructors for class Boop 


Vv public Boop() { 
[VY] public Boop() { } 


} th [VJ public Boop(int i) { 
size =i; 
[YJ public Boop(int i) { 


super () ; 


size = i; © public 


size 


super () ; 


*There’s an exception to this rule; you'll learn it on page 258. 
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Superclass constructors with arguments 


What if the superclass constructor has arguments? Can you pass something in to the 
super() call? Of course. If you couldn’t, you’d never be able to extend a class that didn’t 
have a no-arg constructor. Imagine this scenario: all animals have a name. There’s a 
getName() method in class Animal that returns the value of the name instance variable. 
The instance variable 1s marked private, but the subclass (in this case, Hippo) inherits 
the getName() method. So here’s the problem: Hippo has a getName() method (through 
inheritance) but does not have the name instance variable. Hippo has to depend on the 
Animal part of himself to keep the name instance variable, and return it when someone 
calls getName() on a Hippo object. But...how does the Animal part get the name? The 
only reference Hippo has to the Animal part of himself is through super(), so that’s the 
place where Hippo sends the Hippo’s name up to the Animal part of himself, so that the 
Animal part can store it in the private name instance variable. 


public abstract class Animal { 


rivate String name; €—— All animals Cineluding, 
° 9 subclasses) have a name. 


public String getName() €— ft getter meth 


return name; 'PPO inherits od that 
} 
public Animal(String theName) { The deities 
name = theName; < takes the na 
it th m€ and assigns 
} : e ndme instang, 5 
} Variable. € 
public class Hippo extends Animal { 
. . ‘ Lakes a name. 
public Hippo(String name) { struetor 


Hippo con 


super (name) ; 


Lee It Sends the ndme up the Stack 


€ fnimal eons ruttor 


public class MakeHippo { 
public static void main(String[] args) { 


Hippo h = new Hippo("Buffy") ; <—— Make a Hj 
hme PPe, assing th 

System. out.printin(h.getName () ) ; tonst wae » he Hire 
ruc ) 
Hippo’ inherit” Call the 


} Crited getName() 
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Animal 
private String name 
Animal(String n) 


String getName() 


Hippo 


Hippo(String n) 


[other Hippo- 
specific methods] 


The Animal part of 
me needs to know my name, 
tor that so I take a name in my own Hippo 
constructor and then pass the 
name to super(). 


Sjava MakeHippo 


Buffy 
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calling overloaded constructors 


Invoking one overloaded constructor 
from another 


What if you have overloaded constructors that, with the 
exception of handling different argument types, all do the 
same thing? You know that you don’t want duplicate code 
sitting in each of the constructors (pain to maintain, etc.), so 
you'd like to put the bulk of the constructor code (including 
the call to super()) in only one of the overloaded constructors. 
You want whichever constructor is first invoked to call The 
Real Constructor and let The Real Constructor finish the 
job of construction. It’s simple: just say ¢his(). Or this(aString). 
Or this(27, x). In other words, just imagine that the keyword 
this is a reference to the current object. 


You can say ¢his() only within a constructor, and it must be 
the first statement in the constructor! 


But that’s a problem, isn’t it? Earlier we said that super/() 
must be the first statement in the constructor. Well, that 
means you get a choice. 


Every constructor can have a call to super() 
or this(), but never both! 


You'll need to choose which to call based on which 
values you have, which ones you need to set, and which 
constructors are provided in this class or the superclass. 


import java.awt.Color; 


class Mini extends Car { 
private Color color; 


The no-ar9, constructor 


lies a de 
at the overloaded Kea 
—— Constructor (the one 


calls super ). 


public Mini() { 
this (Color.RED) ; 
} 


public Mini(Color c) { 
super ("Mini") ; 
color CF 
// more initialization 


} 


< ~ does The Real Work 


public Mini(int size) { 
this (Color.RED) ; ; 
super (size) ; Won't work! Can’t have 


eam: and this) in the same 


; constructor, 
must be the first statement! 
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because they each 


all a 


41 another 


Use this() uke 


constructor fro 
constructor 1 


overloaded 
the same class. 
The call to this) 
can he ysed only in a 
e 
constructor, and must 
the first statement in @ 
constructor. 
A constructor can have @ 


call to super\) OR this), 
hut never both! 


fault Color and 
that 


This is The Real Constructor that 
°. 


object Cineluding the call to super()), 


initializing the 


File Edit Window Help Drive 


javac Mini.java 


Mini.java:16: 
be first statement 


call to super must 
in constructor 


super () ; 
aA 
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G harpen your pencil 
NN ——> Yours to solve. 
Some of the constructors in the SonOfBoo class will not 
compile. See if you can recognize which constructors are 
not legal. Match the compiler errors with the SonOfBoo 
constructors that caused them, by drawing a line from the 


compiler error to the “bad” constructor. 


public class Boo { 
public Boo(int i) { } 
public Boo(String s) { } 
public Boo(String s, int i) { } 


} 


File Edit Window Help 
Sjavac SonOfBoo. java 
cannot resolve symbol 


class SonOfBoo extends Boo { 
constructor Boo 


public SonOfBoo() { 
super ("boo") ; 

symbol 

(java.lang.String, java. 


} 
public SonOfBoo(int i) { 
lang.String) 


super ("Fred") ; 
} 
| File Edit Window Help Yadayadayada 
Sjavac SonOfBoo. java 


public SonOfBoo(String s) { 


super (42) ; 
cannot resolve symbol 


constructor Boo 


} 
symbol 
(int, java.lang.String) 


public SonOfBoo(int i, String s) { 


public SonOfBoo(String a, String b, String c) { 
super (a, b); 
| File Edit_Window Help ImNotListening 
Sjavac SonOfBoo. java 


} 


} 


public SonOfBoo(int i, int j) { 
super ("man", j); 
cannot resolve symbol 
symbol:constructor Boo() 


} 


public SonOfBoo(int i, int x, int y) { 
super(i, "star"); 
you are here > 


} 
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object lifespan 


Now we know how an object is born, 
but how long does an object live? 


An object's life depends entirely on the life of references 
referring to it. If the reference is considered “alive,” the object 
is still alive on the Heap. If the reference dies (and we'll look at 
what that means in just a moment), the object will die. 


So if an object’s life depends on the 
reference variable’s life, how long does a 
variable live? 

That depends on whether the variable 1s a local variable or 

an instance variable. The code below shows the life of a local 
variable. In the example, the variable is a primitive, but variable 
lifetime is the same whether it’s a primitive or reference variable. 


public class TestLifeOne { 


public void read() { 
int s = 42; S iss 


Cope, 
sleep () ; method, « the read( 
, ! ) 
} anywhere oo Cant be used 


s=7; 
cn ere 
se * 


wg” variable: an 


€ 
e 
sown Stack fra , 


The Variable Wm 
read) method S alive, but 


stil] See  » . 
the Stack (» eadQ) Co oN Na read() Can 
ond is Po 
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@ A local variable lives only 
within the method that 
declared the variable. 


public void read() { 

int s = 42; 

// ‘s' can be used only 

// within this method. 

// When this method ends, 

// ‘s' disappears completely. 
} 


Variable “s” can be used only within the 
read() method. In other words, the variable 
is in scope only within its own method. No 
other code in the class (or any other class) 


uen 


can see's. 


An instance variable lives 
as long as the object 


does. If the object is still 
alive, so are its instance 
variables. 


public class Life { 
int size; 


public void setSize(int s) { 
size = s; 
// ‘s' disappears at the 
// end of this method, 
// but ‘size’ can be used 
// anywhere in the class 

} 

} 


Variable ’‘s’ (this time a method parameter) 
is in scope only within the setSize() 
method. But instance variable size is 
scoped to the life of the object as opposed 
to the life of the method. 


The difference between life and 
scope for local variables: 


Life 


A local variable is ale as long as its Stack 
frame is on the Stack. In other words, until the 
method completes. 


Scope 


A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the vari- 
able is alive, but not in scope until its method 
resumes. You can use a variable only when 
it is in scope. 


Let’s walk through what happens on the stack 
when something calls the doStufff) method. 


doStuff() goes on the 2) go() plops on top of 

Stack. Variable “b” is the Stack. “x” and “z” 

alive and in scope. are alive and in scope, 
and “b” is alive but not 
in scope. 


While a local variable 1s alive, its state persists. As 
long as method doStufff) is on the Stack, for example, 
the “b” variable keeps its value. But the “b” variable 
can be used only while doStuff{)’s Stack frame is at 
the top. In other words, you can use a local variable 
only while that local variable’s method is actually 
running (as opposed to waiting for higher Stack 
frames to complete). 
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public void doStuff() { 
1 ) boolean b = true; 
go (4) ; 
} 
public void go(int x) { 
int z = x + 24; 
crazy (); 
4] // imagine more code here 
} 


public void crazy() { 


3 } char c = ‘a'; 


} 


crazy() is pushed 4) crazy() completes and 
onto the Stack, with is popped off the Stack, 
“ce” now alive and in so ‘c’ is out of scope 
scope. The other three and dead. When go() 
variables are alive but resumes where it left 
out of scope. off, “x” and “x” are both 


alive and back in scope. 
Variable “b” is still alive 
but out of scope (until 
go() completes). 
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What about reference variables? 


The rules are the same for primitives and references. A reference variable 
can be used only when it’s in scope, which means you can’t use an object’s 
remote control unless you’ve got a reference variable that’s in scope. The real 
question is: 


“How does variable life affect object life?” 


An object is alive as long as there are live references to it. If a reference 
variable goes out of scope but is still alive, the object it refers to 1s still alive on 
the Heap. And then you have to ask...““What happens when the Stack frame 
holding the reference gets popped off the Stack at the end of the method?” 


If that was the only live reference to the object, the object is now abandoned 
on the Heap. The reference variable disintegrated with the Stack frame, so 
the abandoned object is now, officially, toast. The trick is to know the point at 
which an object becomes eligible for garbage collection. 


Once an object 1s eligible for garbage collection (GC), you don’t have to 
worry about reclaiming the memory that object was using. If your program 
gets low on memory, GC will destroy some or all of the eligible objects, to 
keep you from running out of RAM. You can still run out of memory, but 
not before all eligible objects have been hauled off to the dump. Your job 

is to make sure that you abandon objects (i.e., make them eligible for GC) 
when you're done with them, so that the garbage collector has something to 
reclaim. If you hang on to objects, GC can’t help you, and you run the risk 
of your program dying a painful out-of-memory death. 


An object’s life has no 
value, no meaning, no 
point, unless somebody 
has a reference to it. 


Tf you can’t get to it, 
you can’t ask it to do 
anything and it’s just a 
big fat waste of bits. 


But if an object is 
unreachable, the 
Garbage Collector will 
figure that out. Sooner 
or later, that object’s 
goin’ down. 


Three ways to get rid of an object’s reference: 


An object becomes 
eligible for GC when 
its last live reference 
disappears. } 


void go() { 


@) The reference goes out of scope, permanently 


Life z = new Life() et end of 


te ‘z 


cekeren 


@ The reference is assigned another object 


Life z = new Life(); 


z = new Life(); 


the 


©) The reference is explicitly set to null 


Life z = new Life(); 


z = null; 
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Object-killer #1 


Reference goes 
out of scope, 
permanently. 


public class StackRef { 
public void foof() { 
barf (); 


I don't like where 
this is headed. 


} 


public void barf() { 
Duck d = new Duck() ; 


foof() is pushed onto the 
Stack; no variables are 
declared. 


barf() is pushed onto the 
Stack, where it declares 

a reference variable, and 
creates a new object as- 
signed to that reference. 
The object is created on 
the Heap, and the refer- 
ence is alive and in scope. 


Uh-oh. The ‘d’ variable went 
away when the barf() Stack 
Frame was blown off the stack, 
so the Duck is abandoned. 
Garbage—collector bait. 


barf() completes and pops 
off the Stack. Its frame dis- 
integrates, so “d” is now 
dead and gone. Execution 
returns to foof(), but foof() 
can’t use “d.” 
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Object-killer #2 


Assign the reference 
to another object /£ 


Dude, 
all you had to do 


public class ReRef { 
Duck d = new Duck() ; 
was reset the reference. 


Guess they didn't have 
memory management back 


public void go() { 
d = new Duck() ; 


eat 


eRe abe 


tk ooes on the Heap, referenced 
Ace wp is an instance variable, the 
Duck will live as long as the ReRef object 
that instantiated . is alive. Unless... 


Weak 
Suck oe 


Rep f abe” 


‘Wig assianed a new Duck object, leaving the 
ada Duek object Sbandoned. That 


first Duck is now as good as dead. 
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Object-killer #3 


Explicitly set the 
reference to null 


public class ReRef { 
Duck d = new Duck() ; 


public void go() { 
d = null; 
} 


The meaning of null 


When you set a reference to null, you're 
deprogramming the remote control. 

In other words, you've got a remote 
control, but no TV at the other end. A null 
reference has bits representing “null” (we 
don't know or care what those bits are, as 
long as the JVM knows). 


If you have an unprogrammed remote 
control, in the real world, the buttons 
don't do anything when you press them. 
But in Java, you can’t press the buttons 
(i.e., use the dot operator) on a null 
reference, because the JVM knows (this is 
a runtime issue, not a compiler error) that 
you're expecting a bark, but there’s no 
Dog there to do it! 


If you use the dot operator on 


a null reference, you'll get a 


NullPointerException at runtime. You'll 
learn all about exceptions in Chapter 13, 
Risky Behavior. 
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tk ooes on the Heap, referenced 
Necreneee “f ” is an instance variable, the 


Duck will live as long as the ReRef object 
that instantiated - is alive. Unless... 


. . . . . mote 
LW is set to null, which is ust, like having, a remo 
ane Pst wal peoaranned to anything. eee 
even allowed to use the dot operator on da until # 
reprogrammed (assigned an object). 
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Fireside Chats 
, a 
by =~ Y 


Instance Variable 

Td like to go first, because I tend to be more 
important to a program than a local variable. Pm 
there to support an object, usually throughout 
the object’s entire life. After all, what’s an object 
without state? And what is state? Values kept in 
instance variables. 


No, don’t get me wrong, I do understand your 
role in a method; it’s just that your life is so short. 
So temporary. That’s why they call you guys 
“temporary variables.” 


My apologies. I understand completely. 


I never really thought about it like that. What are 
you doing while the other methods are running 
and yow’re waiting for your frame to be the top of 
the Stack again? 
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Tonight’s Talk: An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 


Local Variable 


I appreciate your point of view, and I certainly 
appreciate the value of object state and all, but I 
don’t want folks to be misled. Local variables are 
really important. ‘To use your phrase, “After all, 
what’s an object without behavior?” And what is 
behavior? Algorithms in methods. And you can 
bet your bits there’ll be some Jocal variables in there 
to make those algorithms work. 


Within the local-variable community, the phrase 
“temporary variable” is considered deroga- 
tory. We prefer “local,” “stack,” “automatic,” or 
“Scope-challenged.” 


Anyway, it’s true that we don’t have a long life, 
and it’s not a particularly good life either. First, 
we're shoved into a Stack frame with all the other 
local variables. And then, if the method we’re 
part of calls another method, another frame is 
pushed on top of us. And if ‘hat method calls 
another method...and so on. Sometimes we have to 
wait forever for all the other methods on top of 
the Stack to complete so that our method can run 
again. 


Nothing. Nothing at all. It’s like being in stasis— 
that thing they do to people in science-fiction 
movies when they have to travel long distances. 
Suspended animation, really. We just sit there on 
hold. As long as our frame is still there, we’re safe 
and the value we hold is secure, but it’s a mixed 
blessing when our frame gets to run again. On the 
one hand, we get to be active again. On the other 


Instance Variable 


We saw an educational video about it once. Looks 
like a pretty brutal ending. I mean, when that 
method hits its ending curly brace, the frame is 
literally blown off the Stack! Now éhat’s gotta hurt. 


I live on the Heap, with the objects. Well, not 
with the objects, actually im an object. The object 
whose state I store. I have to admit life can be 
pretty luxurious on the Heap. A lot of us feel 
guilty, especially around the holidays. 


OK, hypothetically, yes, if ?’'m an instance 
variable of the Collar and the Collar gets GC’d, 
then the Collar’s instance variables would indeed 
be tossed out like so many pizza boxes. But I was 
told that this almost never happens. 


They let us drink? 
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Local Variable 


hand, the clock starts ticking again on our short 
lives. ‘The more time our method spends running, 
the closer we get to the end of the method. We all 
know what happens then. 


Tell me about it. In computer science they use the 
term popped as in “the frame was popped off the 
Stack.” That makes it sound fun, or maybe like 
an extreme sport. But, well, you saw the footage. 
So why don’t we talk about you? I know what my 
little Stack frame looks like, but where do you live? 


But you don’t always live as long as the object 
who declared you, right? Say there’s a Dog object 
with a Collar instance variable. Imagine you’re 
an instance variable of the Collar object, maybe 
a reference to a Buckle or something, sitting 
there all happy inside the Collar object who’s all 
happy inside the Dog object. But...what happens 
if the Dog wants a new Collar or nulls out its 
Collar instance variable? That makes the Collar 
object eligible for GC. So...if you’re an instance 
variable inside the Collar and the whole Collar is 
abandoned, what happens to you? 


And you believed it? That’s what they say to 

keep us motivated and productive. But aren’t 

you forgetting something else? What if you’re an 
instance variable inside an object, and that object 
is referenced only by a local variable? If ’m the 
only reference to the object you’re in, when I go, 
you're coming with me. Like it or not, our fates 
may be connected. So I say we forget about all 
this and go get a drink while we still can. Carpe 
RAM and all that. 
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exercise: Be the Garbage Collector 


BE the Garbage Collector 


Which of the lines of code on the right, if added to 
the class on the left at point A, would cause exactly 
one additional object to he eligible for the Garbage 
Collector? (Assume that point A (//call more methods) 
will execute for a long time, giving the Garbage 
Collector time to do its stuff.) 


public class GC { 
public static GC doStuff() { 
GC newGC = new GC(); 
doStuff2 (newGC) ; 
return newGC; 1 copyGC = null; 


————> Answers on page 272. 


2 gc2 = null; 
public static void main(String[] args) { 


GC gcl; 

GC ge? = new GC(); 3  newGC = gc3; 
GC gc3 = new GC(); 

GC gc4 = gc3; 4 gcl = null; 


gcl = doStuff(); 


A) 


// call more methods 
} 7 gc3 = gc2; 


5 newGC = null; 


public static void doStuff2(GC copyGC) { 


8 gcl = gc4; 
GC localGC = copyGC; 


} 9 gc3 = null; 
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q 


Fe 


ei; In this code example, several new objects are created. 
~ Po ular Your challenge is to find the object that is “most popular,’ 
aRCISE i.e., the one that has the most reference variables refer- 
ied ring to it. Then list how many total references there are 
() © for that object, and what they are! We'll start by pointing 
N ects out one of the new objects and its reference variable. 


Good luck! 


class Bees { 
Honey[] beeHoney; 


————— Answers on page 272. 
class Raccoon { 
Kit rk; 
Honey rh; 


class Kit { 
Honey honey; 


class Bear { 
Honey hunny; 


public class Honey { 
public static void main(String[] args) { 
Honey honeyPot = new Honey(); 
Honey[] ha = {honeyPot, honeyPot, honeyPot, honeyPot}; 
Bees bees = new Bees(); 
bees.beeHoney = ha; 
Bear[] bears = new Bear[5]; 
for (int i= 0; i < 5; itt) { 
bears[i] = new Bear(); 
bears[i].hunny = honeyPot; 
} Here’s a new Rattoon object! 
Kit kit = new Kit(); 
kit.honey = honeyPot; 
Raccoon raccoon = new Raccoon (); 


ae Here's its reference variable ‘raccoon.’ 


raccoon.rh = honeyPot; 
raccoon.rk = kit; 
kit = null; 

} // end of main 
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puzzle: Five Minute Mystery 


Five-Minute 


“We’ve run the simulation four times, and the main module’s temperature consistently 
drifts out of nominal toward cold,” Sarah said, exasperated. “We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so we’ve focused our analysis on the heat retention bots, the bots that help to warm the quar- 
ters.” Tom sighed, at first it had seemed that nanotechnology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter’s key life support 
systems were still not passing the simulation gauntlet. 


“What ratios are you simulating?” Tom asked. 


Myster y “Well, if I see where you’re going, we already thought of that,” Sarah replied. “Mission 
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control will not sign off on critical systems if we run them out of spec. We are required 
to run the v3 radiator bot’s SimUnits in a 2:1 ratio with the v2 radiator’s SimUnits,” 
Sarah continued. “Overall, the ratio of retention bots to radiator bots is supposed to run 
4:3.” 


“How’s power consumption, Sarah?” Tom asked. Sarah paused, “Well, that’s 
another thing, power consumption is running higher than anticipated. We’ve got a team 
tracking that down too, but because the nanos are wireless, it’s been hard to isolate the power 
consumption of the radiators from the retention bots.” “Overall power consumption ratios,” Sarah 
continued, “are designed to run 3:2 with the radiators pulling more power from the wireless grid.” 


“OK, Sarah,” Tom said. “Let’s take a look at some of the simulation initiation code. 
We’ ve got to find this problem, and find it quick!” 


import java.util.ArrayList; 


class V2Radiator { 
V2Radiator (ArrayList<SimUnit> list) { 
for (int x = 0; x < 5; x+t+) { 
list.add(new SimUnit ("V2Radiator") ); 


} 


class V3Radiator extends V2Radiator { 
V3Radiator (ArrayList<SimUnit> lglist) { 
super (lglist); 
for (int g = 0; g < 10; gtt) { 
lglist.add(new SimUnit ("V3Radiator") ); 


} 


class RetentionBot { 
RetentionBot (ArrayList<SimUnit> rlist) { 
rlist.add(new SimUnit ("Retention") ); 


} 
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constructors and gc 


5 5 import java.util.ArrayList; 
Five-Minufe 
Mystery public class TestLifeSupportSim { 


public static void main(String[] args) { 
= fe} d ArrayList<SimUnit> aList = new ArrayList<SimUnit>(); 
Coltfinue oo V2Radiator v2 = new V2Radiator(aList); 
V3Radiator v3 new V3Radiator(aList); 
for (int z = 0; z < 20; z+t) { 
RetentionBot ret = new RetentionBot (aList) ; 


class SimUnit { 
String botType; 


SimUnit (String type) { 
botType = type; 


int powerUse() { 
if ("Retention".equals(botType)) { 
return 2; 
} else { 
return 4; 


} 


Tom gave the code a quick look, and a small smile crept across his lips. “I think I’ve 


found the problem, Sarah, and I bet I know by what percentage your power usage readings are off 
too!” 


What did Tom suspect? How could he guess the power readings errors, and what few 
lines of code could you add to help debug this program? 


—————> Answers on page 273. 
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object lifecycle 


Exercise Solutions 


1. copyGc 
2 ge2 = 


3 newGC 


Be the Garbage 


Collector 
(from page 268) 6 


8 gcl = 


9 gc3 = 


= null; No—this line attempts to access a variable 


null; 


= gc3; 


null; 


= null; 


nulls 


gc2; 


gc4; 


noll: 


that is out of scope. 


OK-—gc2 was the only reference variable 


referring to that object. 


No—another out of scope variable. 


OK—gcl had the only reference because 


newGC is out of scope. 
No—newGC is out of scope. 


No—gc3 is still referring to that object. 


No—gc4 is still referring to that object. 


OK—Reassigning the only reference to 


that object. 


No—gc4 is still referring to that object. 


Popular 


Objects 


(from page 269) 


It probably wasn't too hard to figure out that the Honey object first referred to by the honeyPot variable is by 
far the most “popular” object in this class. But maybe it was a little trickier to see that all of the variables that 
point from the code to the Honey object refer to the same object! There are a total of 12 active references 
to this object right before the main() method completes. The kit.honeyPot variable is valid for a while, but 
kit gets nulled at the end. Since raccoon.rk still refers to the Kit object, raccoon.kit.honeyPot (although never 


explicitly declared) refers to the object! 


public class Honey { 


public static void main(String[] 


Honey honeyPot = new Honey(); 


Honey[] ha = {honeyPot, 


args) 


honeyPot, 


honeyPot, honeyPot}; 


Bees bees = new B 


s(); 


bees .beeHoney = ha; 
Bear [] 
for 


bears = new Bear[5]; 
i <6 At), f 
new Bear(); 


(int i = 0; 
bears[i] = 


bears[i].hunny = 
} 
Kit kit = 


honeyPot; 


new Kit(); 


| 


(ends up null ) 
| 


kit.honey = honeyPot; 


Raccoon raccoon = 


raccoon.rh = honeyPot; 


raccoon.rk = kit; 
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kit = null; 
} // end of main 


new Raccoon(); 


{ 


constructors and gc 


Five-Minute Mystery (from pages 270-271) 


Tom noticed that the constructor for the V2Radiator class took an 
ArrayList. That meant that every time the V3Radiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah’s expected ratios 
predicted. 


Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, which printed out a line every time a SimUnit was created, 
would have quickly highlighted the problem! 


youarehere> 273 


10 numbers and statics 


Numbers Matter 


Do the Math. But there’s more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about parsing a String into a number? Or turning a number into a String? Someday 
you're gonna want to put a bunch of numbers into a collection like ArrayList that takes only 
objects. You're in luck. Java and the Java API are full of handy number-tweaking capabilities and 
methods, ready and easy to use. But most of them are static, so we'll start by learning what 

it means for a variable or method to be static, including constants in Java, also known as static 


final variables. 
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Math methods 


MATH methods: as close as you'll 
ever get to a global method 


Except there’s no global anything in Java. But think about this: 
what if you have a method whose behavior doesn’t depend 
on an instance variable value. ‘Take the round() method in the 
Math class, for example. It does the same thing every time— 
rounds a floating-point number (the argument to the method) 
to the nearest integer. Every time. If you had 10,000 instances 
of class Math, and ran the round(42.2) method, you’d get an 
integer value of 42. Every time. In other words, the method 
acts on the argument but is never affected by an instance 
variable state. The only value that changes the way the round() 
method runs is the argument passed to the method! 


Doesn’t it seem like a waste of perfectly good heap space to 
make an instance of class Math simply to run the round() 
method? And what about other Math methods like min(), which 
takes two numerical primitives and returns the smaller of the 
two? Or max(). Or abs(), which returns the absolute value of a 
number. 


These methods never use instance variable values. 
In fact, the Math class doesn’t have any instance variables. So 
there’s nothing to be gained by making an instance of class 
Math. So guess what? You don’t have to. As a matter of fact, 
you can’t. 


If you try to make an instance of 
class Math: 


Math mathObject = new Math() ; 


You’ll get this error: 


File Edit Window Help lwasToldThereWouldBeNoMaths 


$javac TestMath 


access in java.lang.Math 


Math mathObject = new Math() ; 
A 


1 error 
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TestMath.java:3: Math() has private [A N@awe shee di 
Ows 


Constructor iS mai 


means You ¢a eo 
Math dace is a) new on the 


Methods in the Math class 
don’t use any instance 
variable values. And because 
the methods are “Static,” 
you don’t need to have an 
instance of Math. All you 
need is the Math class. 


long x = Math.round (42.2) ; 
int y = Math.min(56, 12); 
int z = Math.abs(-343) ; 


These methods never use 
instandée variables, so theiy 

plaice doesn't need to 
now about a specitie object. 


that the Math 
rked Private! Th, at 


ew Math object. 
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The difference between regular 
(non-static) and static methods 


Java is object-oriented, but once in a while you have a special case, typically 
a utility method (like the Math methods), where there is no need to have an 
instance of the class. The keyword static lets a method run without any 
instance of the class. A static method means “behavior not dependent on 
an instance variable, so no instance/object is required. Just the class.” 


regular (non-static) method static method 


‘) 
|nstance variable value affects the 


a. 
Jay) metho 
public class Song { behavior of the Ply 

String title; 


public Song(String t) { public static int min(int a, int b) { 


} la al //creturns the smallest of a and b 


public void play() { 
SoundPlayer player = new SoundPlayer () ; 


: s. The 
player .playSound (title) ; No instance variable , 


; doesn 
} ‘title hod behavior 
} The eurvent value of the a yee e with instance 
instance variable variable s te- 


ex Pistol 


Politik 


{e) 
Sec t 


Coldplay Son 


5 Math.min (42,36) ; 
eo 
herr 
he Class names rat 
ee eet variable 
name. 
Song 
ae s3.play () ; 
= 382 -Play () NO OBJECT ey 
rete "9 Play) Absoluteh 
Potties wil 62 ran Tay on this anywhere? OBJECTS 
wi it 4 . 
Ply yy Se Way” is Play ause My 4) this Pi¢ture/ 
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static methods 


Call a static method using a 


class name 


Math 


min() 
max() 
abs() 


+ 


Math.min (88,86) ; 


Call a non-static method using a 
reference variable name 


What it means to havea 
class with static methods 


Often (although not always), a class with static methods is not 
meant to be instantiated. In Chapter 8, Serious Polymorphism, 
we talked about abstract classes, and how marking a class 
with the abstract modifier makes it impossible for 
anyone to say “new” on that class type. In other words, z#’s 
impossible to instantiate an abstract class. 


But you can restrict other code from instantiating a 
non-abstract class by marking the constructor private. 
Remember, a method marked private means that only code 
from within the class can invoke the method. A constructor 
marked private means essentially the same thing—only 
code from within the class can invoke the constructor. 
Nobody can say “new” from outside the class. That’s how it 
works with the Math class, for example. The constructor 
is private; you cannot make a new instance of Math. The 
compiler knows that your code doesn’t have access to that 
private constructor. 
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Song t2 


= new Song(); 


t2.play() ; 


This does not mean that a class with one or more static 
methods should never be instantiated. In fact, every class 
you put a main() method in is a class with a static method 
in it! 

Typically, you make a main() method so that you can 
launch or test another class, nearly always by instantiating 
a class in main and then invoking a method on that new 
instance. 


So you're free to combine static and non-static methods in 
a Class, although even a single non-static method means 
there must be some way to make an instance of the class. 
The only ways to get a new object are through “new” or 
deserialization (or something called the Java Reflection 
API that we don’t go into). No other way. But exactly who 
says new can be an interesting question, and one we'll 
look at a little later in this chapter. 
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Static methods can't use non-static 
(instance) variables! 


Static methods run without knowing about any particular instance rf you try to use an 

of the static method’s class. And as you saw on the previous pages, ; 

there might not even de any instances of that class. Since a static instance variable from 
method is called using the class (Math.random()) as opposed to ene’ e 

an instance reference (€2.play()), a static method can’t refer to any inside a Static method, 
instance variables of the class. The static method doesn’t know the compiler thinks, 
which instance’s variable value to use. 


“T don’t know which 


If you try to compile this code: object’s instance 
he variable you're talking 
public class Duck { wrieh ve id hea, . — about!” rf you have ten 
private int size; Whose * ont know about it. Duck objects on the 


public static void main(String[] args) { 


System.out.println("Size of duck is " + size); heap, a static method 
doesn’t know about 


} 


public void setSize(int s) { 


size = s; Static context ag? sien é. any of them. 


else in the tlass is 


public int getSize() { 
return size; 
} 
} 


I'm sure they're 
talking about MY 
size variable. 


No, I'm pretty sure 
they're talking about 
My size variable. 


You’ll get this error: 


File Edit Window Help Quack 
% javac Duck.java 
Duck.java:6: non-static variable 


size cannot be referenced from a 
static context 


System. out.printin("Size 
of duck is " + size); 


A 
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static methods 


Static methods can't use non-static plete? acto 
methods, either! umb Questions 


Q: What if you try to call a non-static 
method from a static method, but the 
non-static method doesn’t use any in- 
stance variables. Will the compiler allow 


What do non-static methods do? They usually use instance 
variable state to affect the behavior of the method. A 


getName() method returns the value of the name variable. Whose that? 
name? The object used to invoke the getName() method. 
= 5 =a Calling getSi QO : A: 2 
This won’t compile: the inevib able. just Postpones * No. The compiler knows that 
. — te size) uses whether you do or do not use instance 
public class Duck { "stance variable. variables in a non-static method, you can. 
private int size; And think about the implications...if you 
were allowed to compile a scenario like 
public static void main(String[] args) { that, then what happens if in the future 
System.out.println("Size is " + getSize()); you want to change the implementation 


of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable in 
the overriding version? 


} 


public void setSize(int s) { 
size = s; 


} 


public int getSize() { 


oblem--- . 
he same yr Q: y 
eeturn else: 4! | could swear I’ve seen code that 


calls a static method using a reference 
} —_= variable instead of the class name. 


A: You can do that, but as your mother 
always told you, “Just because it’s legal 
doesn’t mean it’s good.” Although it works 
Duck.java:5: error: non-static to call a static method using any instance 
method getSize() cannot be refer- of the class, it makes for misleading (less- 
enced from a static context readable) code. You can say, 


System.out.println("Size is " Duck d = new Duck() ; 


getSize()); ae a = {}; 


% javac Duck.java 


ont - This code is legal, but the compiler just 
wetyO resolves it back to the real class anyway 
— (“OK, dis of type Duck, and main() is 
static, so I'll call the static main() in class 


Roses are red, Duck”). In other words, using d to invoke 
known to bloom late main() doesn’t imply that main() will have 
and kn any special knowledge of the object that d 
Statics can’t see is referencing. It’s just an alternate way to 
le state invoke a static method, but the method is 


still static! 
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Static variable: 


value is the same for ALL 
instances of the class 


Imagine you wanted to count how many Duck instances 
are being created while your program is running. How 
would you do it? Maybe an instance variable that you 
increment in the constructor? 


class Duck { 
int duckCount = 0; 
public Duck() { 
duckCount++; this would Shecs 
} duekCount ds ie set 


} cath time 
e 


a Duek Was mad 


No, that wouldn’t work because duckCount is an instance 
variable, and starts at 0 for each Duck. You could try 
calling a method in some other class, but that’s kludgey. 
You need a class that’s got only a single copy of the 
variable, and all instances share that one copy. 


That’s what a static variable gives you: a value shared by 
all instances of a class. In other words, one value per class, 
instead of one value per mstance. 


getSize() 
setSize() 
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& 
j ekCovr’ 
: cone ikialized ONLY 


public class Duck { 
private int size; 
private static int duckCount = 0; 


public Duck() { Now it 
duckCount++; < /nerementing each 4; 
} he Due Construe Ime 


eCause d : 
and Won *L wkCount 


will kee 


public void setSize(int s) { 
size = s; 


} 


public int getSize() { 
return size; 
} 
} 


«Le own cory 
pret goes" & kee® me 
tk 00) vetks 
Re jutkcoun’ \ , Duck en 
gutkCoun’ . ve YO : wk \wes 
Berane | 5 ingle i arial si 
ar sable ec 
ae AES mead of in an 
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static variables 


static variable: kid instance two 
iceCream 


kid instance one 


Static variables are shared. 


All instances of the same 
class share a single copy of 
the static variables. 


instance variables: 1 per instance 
static variables: 1 per class 


—» 


O))) . 
~ Brain Barbell 


Earlier in this chapter, we saw that a private 
constructor means that the class can't be instantiated 
from code running outside the class. In other words, 
only code from within the class can make a new 
instance of a class with a private constructor. (There's 
a kind of chicken-and-egg problem here. ) 


What if you want to write a class in such a way that 
only ONE instance of it can be created, and anyone 
who wants to use an instance of the class will always 
use that one, single instance? 
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Initializing a static variable 


Static variables are initialized when a class ts loaded. A class 1s loaded 
because the JVM decides it’s time to load it. Typically, the JVM 
loads a class because somebody’s trying to make a new instance of 
the class, for the first time, or use a static method or variable of the 
class. As a programmer, you also have the option of telling the JVM 
to load a class, but you’re not likely to need to do that. In nearly all 
cases, you're better off letting the JVM decide when to load the class. 


And there are two guarantees about static initialization: 


numbers and statics 


All static variables 
in a class are 
initialized before 
any object of 

that class can be 
created. 


* — Static variables in a class are initialized before any object of that 
class can be created. 


* — Static variables in a class are initialized before any static method 


eels the elass is loaded 
he playerCount is initialized when the Class is Toad: 

i brain ise initialized it to O, but we don't ei to 

_ since O is the default value for ints. Statie variables 
get default values just like instance variables. 


class Player { 
static int playerCount = 
private String name; 
public Player(String n) { 
name = n; 


playerCount++; Default: values for declared but uni 


| static and instance variables are the same: 
Primitive integers (long, short, ete.): O 


Primitive Floating Points (Float, double): 0.0 
boolean: false | 


nitialized 


public class PlayerTestDrive { 


public static void main(String[] args) { 


System.out.println (Player.playerCount) ; object references: null 


Player one = new Player ("Tiger Woods") ; 


System.out.println (Player.playerCount) ; 


1 Aecess a static variable just like a static 
4 method—with the class name. 


If you don’t explicitly initialize a static variable (by assigning it a val- 
ue at the time you declare it), it gets a default value, so int variables % java PlayerTestDrive 
are initialized to zero, which means we didn’t need to explicitly say 
playerCount = 0. Declaring, but not initializing, a static variable ea Before ey instances are made 
means the static variable will get the default value for that vari- 
able type, in exactly the same way that instance variables are given 


default values when declared. 


1 
te After an object is Created 
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static final constants 


static final variables are constants 


A variable marked final means that—once initialized—it can never 
change. In other words, the value of the static final variable will stay the 
same as long as the class is loaded. Look up Math.PI in the API, and 


you'll find: 


public static final double PI = 3.141592653589793; 
The variable is marked public so that any code can access it. 


The variable is marked static so that you don’t need an instance of 
class Math (which, remember, you’re not allowed to create). 


The variable is marked final because PI doesn’t change (as far as Java 


is concerned). 


There is no other way to designate a variable as a constant, but there 
is a naming convention that helps you to recognize one. Constant 
variable names are usually in all caps! 


Initialize a final static variable: 


@) At the time you declare it: 


public class ConstantInit2 { 
public static final int X_VALUE 


OR 


@ In a static initializer: 


public class ConstantInit3 { 
public static final double VAL; 


static { 
VAL = Math.random() ; 
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A static initializer is a block 
of code that runs whena 
class is loaded, before any 
other code can use the 
class, so it’s a great place 
to initialize a static final 
variable. a 


class ConstantInitl { 
final static int X; 


static { 


If you don't give a value to a final variable 
in one of those two places: 


public class ConstantInit3 { 
public static final double VAL; 


} ho initialization| 


The compiler will catch it: 


File Edit Window Help Init? 


2 


% javac ConstantInit3.java 


ConstantInit3.java:2: error: vari- 
able VAL not initialized in the 
default constructor 


public static final double VAL; 


A 


1 error 


final isn't just for static 
variables... 


You can use the keyword final to modify non-static 
variables too, including instance variables, local 
variables, and even method parameters. In each case, it 
means the same thing: the value can’t be changed. But 
you can also use final to stop someone from overriding a 
method or making a subclass. 


non-static final variables 
class Foof { 
final int size = 3; 
final int whuffie; 


e— now you cant change size 


Foof() { ee, 
whuffie = 42;  « now You an £ change whurrie 
} 


void doStuff (final int x) { 
// you can’t change x 


} 


void doMore() { 
final int z = 7; 
// you can’t change z 
} 
} 


final method 


class Poof { 
final void calcWhuffie() { 
// important things 
// that must never be overridden 


} 
} 


final Class 


final class MyMostPerfectClass { 
// cannot be extended 


} 
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A final variable means you 
can’t change its value. 


A final method means you 
can’t override the method. 


A final class means you 

bi 
can’t extend the class (i.e., 
you can’t make a subclass). 


It's all so...so final. 
I mean, if I'd known 
I wouldn't be able to 
change things... 
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static and final 


there, are_no 


Dumb Questions 


- A static method can’t access a 
non-static variable. But can a non-static 
method access a static variable? 


A: Of course. A non-static method in a 
class can always call a static method in the 
class or access a Static variable of the class. 


: Why would | want to make a class 
final? Doesn't that defeat the whole 
purpose of OO? 


A: Yes and no. A typical reason for 
making a class final is for security. You 
can't, for example, make a subclass of the 
String class. Imagine the havoc if someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphically, where String objects 

are expected. If you need to count ona 
particular implementation of the methods 
in a class, make the class final. 


Q: Isn’t it redundant to have to mark 
the methods final if the class is final? 


A: If the class is final, you don’t need to 
mark the methods final. Think about it—if 
a class is final, it can never be subclassed, 
so none of the methods can ever be 
overridden. 


On the other hand, if you do want to allow 
others to extend your class and you want 
them to be able to override some, but not 
all, of the methods, then don’t mark the 
class final, but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can’t override that 
particular method. 
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_—_______— BULLET POINTS 


A static method should be called using the class 
name rather than an object reference variable: 
Math. random() versus myFoo.go() 


Astatic method can be invoked without any instances 
of the method’s class on the heap. 


Astatic method is good for a utility method that does 
not (and will never) depend on a particular instance 
variable value. 


Astatic method is not associated with a particular 
instance—only the class—so it cannot access any 
instance variable values of its class. It wouldn’t know 
which instance’s values to use. 


Astatic method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 


If you have a class with only static methods and you 
do not want the class to be instantiated, you can mark 
the constructor private. 


A static variable is a variable shared by all members 
of a given class. There is only one copy of a static 
variable in a class, rather than one copy per each 
object for instance variables. 


Astatic method can access a static variable. 


To make a constant in Java, mark a variable as both 
static and final. 


A final static variable must be assigned a value either 
at the time it is declared or in a static initializer: 
static { 

DOG CODE = 420; 
} 


The naming convention for constants (final static 
variables) is to make the name all uppercase and use 
underscores (_) to separate the words. 


A final variable value cannot be changed once it has 
been assigned. 


Assigning a value to a final instance variable must be 
either at the time it is declared or in the constructor. 


A final method cannot be overridden. 


A final class cannot be extended (subclassed). 
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@esharpen your pencil 
eer ae 
What’s Legal? KEEP 


Given everything you've just =m 


learned about static and final, 


which of these would compile? R | G Hi T 


@) public class Foo { 
static int x; 


public void go() { public class Foo4 { 
System.out.println (x) ; static final int x = 12; 
} 
} public void go() { 


System. out.println (x) ; 
} 


@) public class Foo2 { 


int x; 
public static void go() { public class Foo5 { 
System.out.print1n (x) ; static final int x = 12; 
} 
} public void go(final int x) { 


System. out.println (x) ; 
} 


©) public class Foo3 { 
final int x; 
© public class Foo6é { 


public void go() { int x = 12; 
System. out.println (x) ; 
} public static void go(final int x) { 
} System. out.println (x) ; 


} 


—————> Answers on page 308. 
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Math methods 


Math methods 


OW that ¢ k 10 10 static met t h d: l 
N Wi ook at some static methods 1n Class 
WwW WwW hods work, let 8 l k 


Math. This isn’ 
‘ t all of them : : 
: , Just the highh 
cos(), sin(), tan(), ceil(), floor(), and aaa Check your API for the rest includi 
> x uding 


ail Methods Static Methods | Concrete Methods 


Modifier and Type Method Description 

static double abs (double a) Returns the absolute value ofadi 
static float abs(float @) Returns the absolute value of a f 
static int abs (int a) Returns the absolute value of an 
static Long abs(long @) Returns the absolute value of @ a 
static int absExact(int a) Returns the mathematical absolu 


ArithmeticException if the resul 


static tong absExact (Long a) Returns the mathematical absolut 
Arithmeticexception if the rest 


static double acos (double 4) Returns the arc cosine of a value; 
static int addExact (int *, int y) Returns the sum of its arguments. 
static long addexact (long x: Long y¥) Returns the sum of its arguments, 
static double asin(double 4) Returns the arc sine of a value; 
static double atan(double a) Returns the arc tangent of a value 
static double atan2(double y+ double x) Returns the angle theta from the 
static double cbrt(double a) Returns the cube root of a doubl 


static double ceil(double a) Returns the smailest (closest to 
a mathematical integer. 


static double copySign (double magnitude, double sign) Returns the first floating-point a 
static float copySign (float magnitude, float sign) Returns the first floating-point 3! 
static double cos{double a) Returns the trigonometric cosine 


static double cosh(double x) Returns the hnyperbolic cosine of 


Math.abs() 


Returns a d 
i 1 abso ite val e 
1 
ouble t lat ol 1e ue of th 
pias mt The method 1S overloaded, so if you 
Pp int, it returns an i i 
ass it an t int. Pass ita double, it 
int x = Math.abs (-240) ; 


double d = ae 
Math.abs (240.45); // oon ae 
s 240.45 


Math.random() 


Returns a doubl 
e between (and 1 ; 
through (but not maar, including) 0.0 


ange = r Anis 
int 5 ae G jaigge decaat ; Weve “ie ne 
= n 
) (Math.random() * 5); sagen ‘\ Random 
, also wt: 
is 3 tit pacer to vse 
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Math.round() 


Returns an int or a long (depending on 
whether the argument is a float or a double) 


rounded to the nearest integer value. 
: Remember, floating-point literals are assumed 


to be doubles unless you add the ‘f.’ 


int x Math.round(-24.8f£); // returns -25 
int y = Math.round(24.45f); // returns 24 


long z = Math.round(24.45); // returns 24L 
This is a double. 


Math.min() 


Returns a value that is the minimum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles. 


int x = Math.min(24,240) ; // veturns 24 
double y = Math.min(90876.5, 90876.49); // returns 90876.49 


Math.max() 


Returns a value that is the maximum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles. 


int x = Math.max(24,240) ; // returns 240 
double y = Math.max(90876.5, 90876.49); // returns 90876.5 


Math.sqrt() 


Returns the positive square root of the argu- 
ment. The method takes a double, but of 
course you can pass in anything that fits in a 


double. 


double x Math.sqrt (9) ; //return 3 
double y = Math.sqrt(42.0); // returns 6.48074069840786 
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wrapper classes 


Wrapping a primitive 


Sometimes you want to treat a primitive like an 
object. For example, collections like ArrayList only 
work with Objects: 


ArrayList<???> list; 


¢ ereate 3” 


Can ee Lor tse 


ra | 


There’s a wrapper class for every primitive type, 
and since the wrapper classes are in the java.lang 
package, you don’t need to import them. You can 
recognize wrapper classes because each one is 
named after the primitive type it wraps, but with 
the first letter capitalized to follow the class naming 
convention. 


Oh yeah, for reasons absolutely nobody on the 
planet is certain of, the API designers decided not 
to map the names exactly from primitive type to 
class type. You'll see what we mean: 


Boolean 

Character 

hie Watch out! The names aren't 

Short mapped exactly to the primitive 
types. The class names are ully 

unenet spelled out. 

Long 

Float 

ies Give the primitive to the wrap— 


per constructor. That's it: 
wrapping a value 
int i = 288; 
Integer iWrap = new Integer (i) ; 
All the wrappers work 
like this. Boolean has a 


bocleanValue(), Character 


unwrapping a value has a CharValue(), ete. 
int unWrapped = iWrap.intValue() ; 
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primitive 


When you need to treat 
a primitive like an object, 
wrap it. 


Note: the picture at the top is a chocolate in a foil wrapper. Get 
it? Wrapper? Some people think it looks like a baked potato, but 
that works too. 


numbers and statics 


This is stupid. You mean I can't 
just make an ArrayList of ints??? I 
have to wrap every single frickin’ one ina new 
Integer object and then unwrap it when I 

try to access that value in the ArrayList? 
That's a waste of time and an error 
waiting to happen... 


Java will Autobox primitives for you 


In The Olden Days (pre~Java 5), we did have to do all this ourselves, manually 
wrapping and unwrapping primitives. Fortunately, now it’s all done for us 


automatically. 


Let’s see what happens when we want to make an ArrayList to hold ints. 


An ArrayList of primitive ints 


Make an ferayList of type Integer: 


public void autoboxing() { 


int x = 32; | 
ArrayList<Integer> list = new ArrayList<Integer>() ; 
PERCHA ACS Jat aia tl Although there is NOT a method in ArrayList 


: : for add(int), the compiler does all the wrapping 
ink he & Sse gok(0y 5 (boxing) for you. In other words, there really |S 
} an Integer object stored in the ArrayList, but 
oe you get to “pretend” that the AreayList takes 
eghe “ ler automatically eh Sala We cas 
ress ae ° ject So You Can assign the int value  AerayList<|nteger>.) 
suis Y to a Primitive without having to call th 
intValue() method on the Integer object ° 


there, are no , 
Dumb Questions 


Why not declare an ArrayList<int> if you want to hold ints? 


A: Because...you can’t. At least, not in the versions of Java this book covers (the language 
is constantly evolving and things may change!). Remember, the rule for generic types is that 
you can specify only class or interface types, not primitives. So ArrayList<int> will not com- 
pile. But as you can see from the code above, it doesn’t really matter, since the compiler lets 
you put ints into the ArrayList<Integer>. In fact, there's really no way to prevent you from 
putting primitives into an ArrayList where the type of the list is the type of that primitive’s 
wrapper, since autoboxing will happen automatically. So, you can put boolean primitives in 
an ArrayList<Boolean> and chars into an ArrayList<Character>. 


youarehere> 291 


autoboxing everywhere 


Autoboxing works almost everywhere 


Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to use primitives in a collection...it also lets you use either 
a primitive or its wrapper type virtually anywhere one or the other is 
expected. Think about that! 


Fun with autoboxing 


Method arguments 3 


If a method takes a wrapper type, you F | 


can pass a reference to a wrapper or 2 
% Rg int 
Teger oN, [ 


a primitive of the matching type. And 
of course the reverse is true—if a 
void takeNumber (Integer i) { } 


method takes a primitive, you can 
pass in either a compatible primitive 
or areference to a wrapper of that 
primitive type. 


Return values int giveNumber() { 
If a method declares a primitive return x; 
return type, you can return either a } 
compatible primitive or a reference Lf 
to the wrapper of that primitive type. 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 


y oS 

primitive of the matching type. “ger © int 
Boolean expressions vue 

Any place a boolean value is expected, 

you can use either an expression & 

that evaluates to a boolean (4 > 2), a COfean OY boolean 

primitive boolean, or a reference toa 

Boolean wrapper. 

if (bool) { 
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System.out.printlin ("true"); 
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Operations on numbers 


This is probably the strangest one—yes, 

you can use a wrapper type as an operand 
in operations where the primitive type is 
expected. That means you can apply, say, 


the increment operator against a reference 


to an Integer object! 


But don't worry—this is just a compiler trick. 


The language wasn't modified to make the 
operators work on objects; the compiler 


simply converts the object to its primitive 


type before the operation. It sure looks 
weird, though. 


Integer i = new Integer(42); 


i++; 


And that means you can also do things like: 


Integer j = new Integer(5); 
Integer k = j + 3; 


Assignments 


You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 


or primitive. For example, a primitive int 


variable can be assigned to an Integer 
reference variable, and vice versa—a 
reference to an Integer object can be 
assigned to a variable declared as an int 
primitive. 


G harpen our pencil 
“ 


Will this code compile? Will it run? If it runs, 


Ww 
me U 
eger OOS 


Integer intVal = x; 


3 
OU 
“feger OPS int 
i++; 
3 


public class TestBox { 
private Integer i; 
private int j; 


what will it do? public static void main(String[] args) { 


Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn’t talk about. 


You'll have to go to your compiler to find 
the answers. (Yes, we're forcing you to 
experiment, for your own good, of course.) 


—+> Yours to solve. } 


public void go() { 


TestBox t = new TestBox(); 


System.out.println(j) ; 
System.out.println (i) ; 
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But wait! There’s more! Wrappers 
have static utility methods too! 


Besides acting like a normal class, the wrappers have a bunch 
of really useful static methods. 


For example, the parse methods take a String and give you 
back a primitive value. 
Method in the Integer 
class that knows how to 


apre” “parse” a String into ; 
Lae “ int it nee the Takes a String 


N 
Integer.parseInt (“3”) 


Converting a String toa No prablem to parse 
primitive value is easy: “9” into L- 
String s = "2"; clear) 
int x = Integer.parseInt(s) ; The eee tre 
double d = Double.parseDouble ("420.24") ; ae arate ” 
Chrind, araumen 


boolean b = Boolean.parseBoolean ("True") ; 


But if you try to do this: 


Uh-oh. This compiles just Fine, but 
String t = "two"; at runtime it blows up. Anything 
int y = Integer.parseInt (t) ; that can’t be parsed as a number 

will cause a NumberFormatException. 


You'll get a runtime exception: 


File Edit Window Help Clue 
% java Wrappers 


Exception in thread "main" java.lang.NumberFormatException: 
For input string: "two" 


at java.base/java.lang.NumberFormatException.forInputStri 
ng (NumberFormatException. java: 65) 


at java.base/java.lang.Integer.parseInt (Integer. java:652) 


at java.base/java.lang.Integer.parseInt (Integer. java:770) 


at Snippets.badParse (Snippets. java: 48) 
at Snippets.main(Snippets.java:54) 
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Every method or 
constructor that parses 
a String can throw a 
NumberFormatException. 
It’s a runtime exception, 
so you don’t have to 
handle or declare it. 

But you might want to. 


(We'll talk about exceptions in 
Chapter 13, Risky Behavior.) 


numbers and statics 


And now in reverse..turning a 
primitive number into a String 


You may want to turn a number into a String, for example when you want to show this 
number to a user or put it into a message. There are several ways to turn a number into 
a String. The easiest is to simply concatenate the number to an existing String. 


the ‘+" operator is overloaded in 


member ) asa 
double d = 42.5; Fre only overland ed toa 
String doubleString = "" + d; String concatend a vA. 
Ching, becomes String! 
double d = 42.5; an Another way to do it ising archaits 


String doubleString = Double.toString(d) ; method in class Double. 


double d = 42.5; There's also an overloaded a static method 
String doubleString = String.valueOf (d) ; Kueh” on Shing that will get the 
String value of pretty much anything; 


Yeah, 
but how do I make 

it look like money? With a 
dollar sign and two decimal 
places like $56.87 or what if I 

want commas like 45,687,890 
or what if I want it in... 


Where's my printf 
like I have in C? Is 

number formatting part of 
the I/O classes? 
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Number formatting 


In Java, formatting numbers and dates doesn’t have to be coupled with I/O. Think about it. 
One of the most typical ways to display numbers to a user is through a GUI. You put Strings 
into a scrolling text area, or maybe a table. If formatting was built only into print statements, 
you'd never be able to format a number into a nice String to display ina GUL 


The Java API provides powerful and flexible formatting using the Formatter class in java.util. 
But often you don’t need to create and call methods on the Formatter class yourself, because 
the Java API has convenience methods in some of the I/O classes (including printf{)) and 
the String class. So it can be a simple matter of calling a static String.format() method and 
passing it the thing you want formatted along with formatting instructions. 


Of course, you do have to know how to supply the formatting instructions, and that takes 
a little effort unless you’re familiar with the printf) function in C/C++. Fortunately, even 
if you don’t know printf(), you can simply follow recipes for the most basic things (that we’re 
showing in this chapter). But you wzl/ want to learn how to format if you want to mix and 
match to get anything you want. 


We'll start here with a basic example and then look at how it works. (Note: we’ll revisit 
formatting again in Chapter 16, Saving Objects.) 


Making big numbers more readable with underscores, a quick detour 


Before we get into formatting numbers, let’s take a small, useful detour. Sometimes you'll 
want to declare variables with large initial values. Let’s look at three declarations that assign 
the same large value, a billion, to long primitives: bed 
voperly locate 

long hardToRead = 1000000000; When you're assigning large ieee Y 

: % \ 7 
long easierToRead = 1_000_000_000; 27 avcrores will make your 
long legalButSilly = 10 0000 0000; 


Formatting a number to use commas 
The number fo format (we 


public class TestFormats { want it to have Lommas)- 


public static void main(String[] args) { 
long myBillion = 1 000 000 000; 
String s = String.format("%,d", myBillion) ; 


System.out.println(s); <= 


instructions for how to format 


’ 7 Case is an int 
re on 
F . aoe 556 566 oe pe the Eat et aria 
| --1,000,000,000 | eral, so it isp’ i 

ia sliraies resi isn ¢ Separating arguments 


Now we get Commas inserted into the numb 
umber. 
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Formatting deconstructed... 


At the most basic level, formatting consists of two main parts (there is 
more, but we’ll start with this to keep it cleaner): 


4) Formatting instructions 


You use special format specifiers that describe how 


the argument should be formatted. Note: if you already know print ( 


Crom CHA you 8 probably jet 
mn : a 
@) The argument to be formatted. rom oe next few PaQes 


vead caresully! 
Although there can be more than one argument, we'll 


start with just one. The argument type can’t be just 
anything...it has to be something that can be formatted 
using the format specifiers in the formatting instructions. 
For example, if your formatting instructions specify a 
floating-point number, you can’t pass in a Dog or even 
a String that looks like a floating-point number. 


Do this: to this. 
@ @ 
format ("%,d", 1 000 000 000); 
ye ON 


Use these instructions...on this argument. 


What do these instructions actually say? 


“Take the second argument to this method, and format it 


as a decimal integer and insert commas.” 


How do they say that? 


On the next page we’ll look in more detail at what the syntax “%,d” 
actually means, but for starters, any time you see the percent sign (°o) 
in a format String (which is always the first argument to a format() 
method), think of it as representing a variable, and the variable is the 
other argument to the method. The rest of the characters after the 
percent sign describe the formatting instructions for the argument. 
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the format() method 


The percent (%) says, “insert argument here” 
(and format it using these instructions) 


The first argument to a format() method is called the format String, and it can 
actually include characters that you just want printed as-is, without extra formatting. 
When you see the % sign, though, think of the percent sign as a variable that 
represents the other argument to the method. 


More th 
ast icky i ore Characters to 


inélude in the Styi 
Characters to intlude in 4 serie on to the he second cd ia 
the final String, returned method (the number), ormatted and inserted. 


mat(). 
from forma » ne na 


—_—_—_—_—eao—e—ermwsu 


fraument to be 


ormatted. 


—\_M— 
String.format("I have %.2£, bugs to fix.", 476578.09876) ; 
Qn! 


/ 


Outgut I have 476578.10 bugs to fix. 


Notice | 
ie eta some of Lhe numbers af_ 


the ba i Can You Suess what 


The “%” sign tells the formatter to insert the other method argument (the second 
argument to format(), the number) here, AND format it using the “.2f” characters 
after the percent sign. Then the rest of the format String, “bugs to fix,” is added 
to the final output. 


Adding a comma 


fo) 


String. format ("I have %,.2Z2£ bugs to fiz.", 476578.09876) ; 


I have 476,578.10 bugs to fix. 


chanai ‘ format instructions 
ta me) ” bo %,.2£", we got a 
Comma in the formatted number. 
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But how does it even KNOW 
where the instructions end and the 
rest of the characters begin? How come it 
doesn't print out the “f" in "%.2f"? Or the 
"2"? How does it know that the .2f was 
part of the instructions and NOT 
part of the String? 


The format String uses its 
own little language syntax 


You obviously can’t put just anything after the “°%o” 
sign. The syntax for what goes after the percent 
sign follows very specific rules, and describes how to 
format the argument that gets inserted at that point 
in the result (formatted) String, 


You've already seen some examples: 


%,d means “insert commas and format the number 
as a decimal integer.” 


and 


% .2f means “format the number as a floating point 
with a precision of two decimal places.” 


and 


%,.2£ means “insert commas and format the 
number as a floating point with a precision of two 
decimal places.” 


Really the question 1s: “How do I know what to put 
after the percent sign to get it to do what I want?” 
And that includes knowing the symbols (like “d” 

for decimal and “f” for floating point) as well as 

the order in which the instructions must be placed 
following the percent sign. For example, if you put 
the comma after the “d” like “°/d,” instead of “°%,d” 
it won’t work! 


Or will it? What do you think this will do: 


String. format("I have %.2f£, bugs to fix.", 476578.09876) ; 


(We'll answer that on the next page.) 
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The format specifier 


Everything after the percent sign up to and including the type indicator (like “d” 

or “f”) is part of the formatting instructions. After the type indicator, the formatter 
assumes the next set of characters is meant to be part of the output String, until or 
unless it hits another percent (°%) sign. Hmmmm...is that even possible? Can you have 
more than one formatted argument variable? Put that thought on hold for right now; 
we'll come back to it in a few minutes. For now, let’s look at the syntax for the format 


specifiers—the things that go after the percent (%) sign and describe how the argument 
should be formatted. 


A format specifier can have up to five different parts (not 
including the “%”). Everything in brackets [ ] below is optional, so 
only the percent (%) and the type are required. But the order is 
also mandatory, so any parts you DO use must go in this order. 


% [argument aaa taal? Sakae a 


ial get to this later... This defines the MINI- You Se know a is mandatory 
a; You say WHICH These are for ie MUM number of char— this one---1 defines i the ea page) 
argument if there’s more formatting om acters that will be used. the precision. | In and will usually ly be 


han one. (Don't worr Ling, Commas) * * ds, ¥ ay decimal 
like inser i) That’s minimum not ther words, a for a ae : 

about it just yet.) Y putting F negative TOTAL. If the number on the number integer or “f” for 

numbers in paren— is ee than the width, of ae veg 3 floating-point 


theses, oF ee itll still be used in full, Dor't £ orget, 
the numbers '¢ but if it’s less than the intlude the - i” 
justified. width, it'll be padded there. 


with zeros. 


number: 


$[argument number] [flags] [width] [.precision] type 


aN ae 


format("%,6.1£", 42. ee 


There’s no bey value WC kL. 
gument number” Ea Lord 
jPecified im this form grt Oe ant 
but all fie tier rmat String, “ ote nor 


Pieces are thong 
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The only required specifier is for TYPE 


Although type is the only required specifier, remember that if you do put in 
anything else, type must always come last! ‘There are more than a dozen different 
type modifiers (not including dates and times; they have their own set), but most 
of the time you'll probably use “od (decimal) or of (floating point). And typically 
you'll combine °of with a precision indicator to set the number of decimal places 
you want in your output. 


The TYPE is mandatory, everything else is optional. You must include a 
type in your format 

%d decimal vo A ae would not workl [1 vy P y 

format ("%d", 42); Vs se the same as +. bas instructions, and if you 
assi 
int variable 2” © Gouble to an specify things hesides 
The argument must be compatible with an int, so that means only tvpe the tvpe must 
YP® YP 


byte, short, int, and char (or their wrapper types). 


always come last. 
the “ ” 


at -Moaeng port Here we Combined ive Most otf the time, 
format ("%.3£", 42.000000) —_ witha precision 
“2” so we ended up WI 


Hycen eer you'll probably format 


numbers using either 


The argument must be of a floating-point type, so that means a Wes sens 
only a float or double (primitive or wrapper) as well as something d for decimal or f 
called BigDecimal (which we don’t look at in this book). 


for floating point. 


%x hexadecimal 
format ("Sx", 42) 


The argument must be a byte, short, int, long (including both 
primitive and wrapper types), and BigInteger. 


%C character 
format ("%e" , 42) The number AL represents 


al 


The argument must be a byte, short, char, or int (including both 
primitive and wrapper types). 
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What happens if I have more than one argument? 


Imagine you want a String that looks like this: 
“The rank is 20, 456,654 out of 100,567,890. 24.” 


But the numbers are coming from variables. What do you do? You simply add two arguments 
after the format String (first argument), so that means your call to format() will have three 
arguments instead of two. And inside that first argument (the format String), you'll have two 
different format specifiers (two things that start with “%o”). The first format specifier will insert 
the second argument to the method, and the second format specifier will insert the third 
argument to the method. In other words, the variable insertions in the format String use the 
order in which the other arguments are passed into the format() method. 


int one = 20456654; 
double two = 100567890.248907; 


String s = String.format ("The rank is %,d out of %,.2£", one, two); 


er, 


Wh 
The rank is 20,456,654 out of 100,567,890.25 Shue. have more than one 
i a the i 


Y re inserted 


Using the ord i 
We added commas to both variables and Pass them to ‘A Ng le ou 
restricted the Floating—point number (the method. ormat() 


second variable) to two decimal places. 


As you'll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That’s probably hard to imagine until you see how 
date formatting (as opposed to the number formatting we’ve been doing) works. Just know that in 
a minute, you'll see how to be more specific about which format specifiers are applied to which 
arguments. 


there are no 


Dumb Questions 


- Um, there’s something REALLY strange going on here. Just how many arguments can | 
pass? | mean, how many overloaded format() methods are IN the String class? So, what happens 
if | want to pass, say, ten different arguments to be formatted for a single output String? 


A: Good catch. Yes, there is something strange going on, and no there are not a bunch of 
overloaded format() methods to take a different number of possible arguments. In order to support 
this formatting (printf-like) API in Java, the language needed another feature—variable argument 
lists (called varargs for short). We'll talk about varargs more in Appendix B. 
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Just one more thing...static imports 


Static imports are a real mixed blessing. Some people love this idea, 
some people hate it. Static imports exist to make your code a little 
shorter. If you hate to type or hate long lines of code, you might just 
like this feature. The downside to static imports is that—if you’re 
not careful—using them can make your code a lot harder to read. 


The basic idea is that whenever you’re using a static class, a static 
variable, or an enum (more on those later), you can import them 
and save yourself some typing. 


Without static imports: 


class NoStatic { 


public static void main(String[] args) { 


System.out.printin("sqrt " + Math.sqrt(2.0)); 


System.out.printin("tan " + Math.tan(60)); 


pre 3% 


Same code, with static imports: 


import static java.lang.Math.*; 
import static java.lang.System.out; 
class WithStatic { 


public static void main(String[] args) { 


Ouleyoprintln("sqrt " + (Sqpee(2.0)); 


pgue ror ™ 
out.printin("tan " + tan(60)))\ © ioe 
at ov. 
} oe _ ‘i You might want to use 
vy be 8 Bap eo ior at ic imports Foy these 


methods. 4 mak 
Code shorter, ae = 
don’t need the “Math,” 


prefix to understand 


what these operations are, 


numbers and statics 


Use carefully: 


Static imports can 
make your code 
confusing to read. 


Always re-read 
your code after 
using a static import 
and think: "Will I 
understand this in 
six months time?” 


use wher 


katie gor” 


Caveats & Gotchas —— 


Using a static import removes the information 
about which class the static came from. We'd 
advise using static imports only when the static 
method or variable still means something 
when it’s not prefixed with the class name. 


A big issue with static imports is that 

it's easy to create naming conflicts. For 
example, if you have two different classes 
with an “add()” method, how will you and 
the compiler know which one to use? So 
it's best not to use a static import if it’s 
possible to create a conflict. 


Notice that you can use wildcards (.*), in 
your static import declaration. 
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static vs. instance 


Fireside Chats 
, 
Ny a + 


Instance Variable 

I don’t even know why we’re doing this. Everyone 
knows static variables are just used for constants. 
And how many of those are there? I think the 
whole API must have, what, four? And it’s not like 
anybody ever uses them. 


Full of it. Yeah, you can say that again. OK, so 
there are a few in the Swing library, but everybody 
knows Swing 1s just a special case. 


Ok, but besides a few GUI things, give me an 
example of just one static variable that anyone 
would actually use. In the real world. 


Well, that’s another special case. And nobody uses 
that except for debugging anyway. 


chapter 10 


Tonight’s Talk: An instance variable 
takes cheap shots at a static variable 


Static Variable 


You really should check your facts. When was the 
last time you looked at the API? It’s frickin’ loaded 
with statics! It even has entire classes dedicated 

to holding constant values. ‘There’s a class called 
SwingConstants, for example, that’s just full of 
them. 


It might be a special case, but it’s a really 
important one! And what about the Color class? 
What a pain if you had to remember the RGB 
values to make the standard colors! But the color 
class already has constants defined for blue, 
purple, white, red, etc. Very handy. 


How’s System.out for starters? The out in System. 
out is a static variable of the System class. You 
personally don’t make a new instance of the 
System; you just ask the System class for its out 
variable. 


Oh, like debugging isn’t important? 


And here’s something that probably never crossed 
your narrow mind—let’s face it, static variables 
are more efficient. One per class instead of one 
per instance. The memory savings might be huge! 


Instance Variable 


Um, aren’t you forgetting something? 


Static variables are about as un-OO as it gets!! 
Gee, why not just go take a giant backward step 
and do some procedural programming while 
we're at it. 


You're like a global variable, and any programmer 
worth their sticker-covered laptop knows that’s 
usually a Bad Thing. 


Yeah, you live in a class, but they don’t call it 
Class-Oriented programming. That’s just stupid. 
You're a relic. Something to help the old-timers 
make the leap to Java. 


Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse of 
static variables (and methods) is the mark of an 
immature OO programmer. A designer should be 
thinking about olyect state, not class state. 


Static methods are the worst things of all, because 
it usually means the programmer is thinking 
procedurally instead of about objects doing things 
based on their unique object state. 


numbers and statics 


Static Variable 


What? 


What do you mean uwn-OO? 


Iam NOT a global variable. There’s no such 
thing, I live in a class! That’s pretty OO you know, 
a CLASS. [’m not just sitting out there in space 
somewhere; I’m a natural part of the state of an 
object; the only difference is that ’'m shared by all 
instances of a class. Very efficient. 


Alright just stop right there. THAT is definitely 
not true. Some static variables are absolutely 
crucial to a system. And even the ones that aren’t 
crucial sure are handy. 


Why do you say that? And what’s wrong with 
static methods? 


Sure, I know that objects should be the focus of 
an OO design, but just because there are some 
clueless programmers out there...don’t throw the 
baby out with the bytecode. There’s a time and 
place for statics, and when you need one, nothing 
else beats it. 
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be the compiler 


BE the Compiler 


The Java file on this page represents a 
complete program. Your job is to play 
compiler and determine whether this 
file will compile. If it won’t compile, 
how would you fix it? When 
it runs, what would be its 
output? 


class StaticSuper { 
static { 
System.out.printin("super static block"); 


Which of these is the output? 
StaticSuper () { 


System.out.printin("super constructor"); 


Possible Output 


$java StaticTests 
public class StaticTests extends StaticSuper { Seeig Piles A 


static int rand; 


in main 


super static block 
static { 


rand = (int) (Math.random() * 6); 
System.out.printin("static block " + rand); 


super constructor 


constructor 


StaticTests() { 


System.out.printin("constructor") ; 
Possible Output 


: : : : : $java StaticTests 
public static void main(String[] args) { 


super static block 


System.out.printin("in main"); 
static block 3 


StaticTests st = new StaticTests(); : ; 
in main 


super constructor 


constructor 


————— Answers on page 308. 
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numbers and statics 


This chapter explored the wonderful, static world 
of Java. Your job is to decide whether each of the 
following statements is true or false. 


© Trve or Farse® 


1. To use the Math class, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don’t have access to instance variable state of the “this” object. 
4, It is good practice to call a static method using a reference variable. 
5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable. 

8. A static initializer block runs before a class’s constructor runs. 

9. If a class is marked final, all of its methods must be marked final. 

10. A final method can be overridden only if its class is extended. 

11. There is no wrapper class for boolean primitives. 

12. A wrapper is used when you want to treat a primitive like an object. 
13. The parseXxx methods always return a String. 


14. Formatting classes (which are decoupled from I/O) are in the java.format package. 


———— Answers on page 308. 
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Exercise Solutions 


oer your pencil (from page 287) 


1,4, 5, and 6 are legal. 


2 doesn't compile because the static 
method references a non-static instance 
variable. 


3 doesn't compile because the instance 
variable is final but hasn't been initialized. 


BE the Compiler 


(from page 306) 


StaticSuper QO : 
System. out.println ( 


"super constructor"); 


StaticSuper is a constructor and must 
have ( ) in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both classes run before either 
of the constructors run. 


pewilbea er 
Net Oa ated none fee 


Output Ms) ko GS wnclusive- 


File Edit Window Help Cling \ 


$java StaticTests 


super static block 
static block 3 

in main 

super constructor 


constructor 
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Trve or Fatse (from page 307) 


1. To use the Math class, the first step is to make 
an instance of it. 

2. You can mark a constructor with the keyword 
“static.” 

3. Static methods don’t have access to an object’s 
instance variables. 

4. It is good practice to call a static method using a 
reference variable. 

5. Static variables could be used to count the in- 
stances of a class. 

6. Constructors are called before static variables 
are initialized. 

7. MAX_SIZE would be a good name for a static 
final variable. 

8. A static initializer block runs before a class’s 
constructor runs. 

9. If a class is marked final, all of its methods must 
be marked final. 

10. A final method can be overridden only if its 
class is extended. 

11. There is no wrapper class for boolean primi- 
tives. 

12. A wrapper 1s used when you want to treat a 
primitive like an object. 

13. The parseXxx methods always return a String. 
14. Formatting classes (which are decoupled from 


I/O) are in the java.format package. 


False 


False 


True 


False 


True 


False 


True 


True 


False 


False 


False 


True 


False 


False 
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Data Structures 


Sheesh...and all 
this time I could have 
just let Java put things in 
alphabetical order? Third 
grade really sucks. We never 
learn anything useful... 


Sorting isa snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms (unless you're reading this right 
now sitting in your Computer Science 101 class, in which case, trust us—you are SO going to be 
writing sort code while the rest of us just call a method in the Java API). In this chapter, you're 
going to get a peek at when Java can save you some typing and figure out the types that you 


need. 


The Java Collections Framework has a data structure that should work for virtually anything 
you'll ever need to do. Want to keep a list that you can easily keep adding to? Want to find 
something by name? Want to create a list that automatically takes out all the duplicates? Sort 
your co-workers by the number of times they’ve tried to speak with their mic muted on a video 


call? Sort your pets by number of tricks learned? It’s all here... 
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sorting a list 


Tracking song popularity on your jukebox 


Congratulations on your new job—managing the automated 


jukebox system at Lou’s Diner. There’s no Java inside the jukebox 
itself, but each time someone plays a song, the song data is 
appended to a simple text file. 


Your job is to manage the data to track song popularity, 

generate reports, and manipulate the playlists. You’re not writing the entire app—some of the 
other software developers are involved as well, but you’re responsible for managing and sorting 
the data inside the Java app. And since Lou has a thing against databases, this 1s strictly an in- 
memory data collection. Another programmer will be writing the code to read the song data 
from a file and put the songs into a List. (In a few chapters you'll learn how 

to read data from files, and write data to files.) All you’re going to get is a 


? e 
List with the song data the jukebox keeps adding to. You ll often want to write 
Let’s not wait for that other programmer to give us the actual file of some temporary code that 


songs; let’s create a small test program to provide us with some sample 


data we can work with. We’ve agreed with the other programmer that stands in for the Teal code 
she’ll ultimately provide a Songs class with a getSongs method we'll use to that will come later This 9 


get the data. Armed with that information, we can write a small class to 
temporarily “stand in” for the actual code. Code that stands in for other called “mocking ” 


code is often called “mock” code. 


e'll use th : 
te oe a 
We'll make this pies statit 
because this tlass doesn ; , | 
—~ eCause ArrayList IS-A Li 
— i ; ist, we Can er, 
class aie ag Acer t need any: an ArrayList, Store it in a List, and iia 


List from the method. 
In the veal world you'll often see Java ode 


public static List<String> getSongStrings() { 


List<String> songs = new ArrayList<>() ; that r : 
songs.add("somersault") ; hid eturns the interface type (List) and 
a bays Ides the Im lem tati 

songs.add ("cassidy") ; Plementation type (Avra List) 
songs.add("$10") ; Tie wil ¥ ; 
songs. add ("havana") ; to nr be Our lise 
songs. add ("Cassidy") ; with, of ‘six ¢ 
songs.add("50 Ways") ; "9 titles 
return songs; 

} 
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Your first job, sort the songs in alphabetical order 


We'll start by creating code that reads in data from the mock Songs class and prints 
out what it got. Since an ArrayList’s elements are placed in the order in which they 
were added, it’s no surprise that the song titles are not yet alphabetized. 


import java.util.*; 


public class Jukeboxl { 
public static void main(String[] args) { : 
new Jukeboxl1().go(); We'll store the sond ty 


| a List of Strings: 
public void go() { 


List<String> songList = MockSongs.getSongStrings () ; 
System.out.println(songList) ; 


Then pri 
} x the Ae contents of 


tes in 3 


} 


// Below is the "mock" code. A stand in for the actual 
// 1/0 code that the other programmer will provide later 


class MockSongs { 
public static List<String> getSongStrings() { 


List<String> songs = new ArrayList<>(); seivle data we 
songs.add("somersault") ; N hing special here.-.just ate if . 
songs.add("cassidy") ; ovhin our sorting Code: 

sie ep ote tan use to work on 
songs.add("havana") ; 

songs.add ("Cassidy") ; 


songs.add("50 Ways"); 
return songs; 


Sjava Jukebox1l etd 
[somersault, cassidy, $10, havana, ce This is de 
Cassidy, 50 Ways] 


finitely NOT alphabetical! 
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the diamond operator 


Before we get onto sorting, 
T have a question about the way the songDB 
ArrayList was declared on the last page. Normally, 
you have to put the type of the object in the 

ArrayList inside angle brackets on both sides of the 
equals sign. But on the last page, there was an empty 
set of brackets on the right-hand side. Is this 
special syntax? 


Great question! You spotted the diamond operator 


So far, we’ve been declaring our ArrayLists by showing the element type twice: 


ArrayList<String> songs = new ArrayList<String>() ; 


Most of the time, we don’t need to say the same thing twice. The compiler can 
tell from what you wrote on the left-hand side what you probably want on the 
right-hand side. It uses type inference to infer (work out) the type you need. 


ArrayList<String> songs = new ia eee No type needed 


This syntax is called the diamond operator (because, well, it’s diamond-shaped!) 
and was introduced in Java 7, so it’s been around a while and is probably 
available in your version of Java. 


Over time, Java has evolved to remove 
unnecessary code duplication from its 
syntax. If the compiler can figure out 
a type, you don’t always need to write 
it out in ful]. 
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Dumb Questions 


+ Should Ibe using the diamond operator all 
the time? Are there any downsides? 


A: The diamond operator is “syntactic sugar,” which 
means it’s there to make our lives easier as we write 
(and read) code, but it doesn’t make any difference to 
the underlying byte code. So if you're worried about 
whether using the diamond means something differ- 
ent to using the specific type, don’t worry! It’s basically 
the same thing. 


However, sometimes you might choose to write out 
the full type. The main reason you might want to is 

to help people reading your code. For example, if the 
variable is declared a long way from where it’s initial- 
ized, you might want to use the type when you initial- 
ize it so you can see clearly what objects go into it. 


ArrayList<String> songs; 
// lots of code between these lines... 


songs = new ArrayList<String>() ; 


Q: Are there any other places the compiler can 
work out the types for me? 


A: Yes! For example, the var keyword (“Local 
Variable Type Inference”), which we'll talk about in 
Appendix B. And another important example, lambda 
expressions, which we will see later in this chapter. 


collections with generics 


Q: I saw you were creating an ArrayList 
but assigning it to a List reference, and that 
you created an ArrayList but returned a List 
from the method. Why not just use ArrayList 
everywhere? 


A: One of the advantages of polymor- 
phism is that code doesn’t need to know the 
specific implementation type of an object to 
work well with it. List is a well-known, well- 
understood interface (which we'll see more of 
in this chapter). Code that is working with an 
ArrayList doesn’t usually need to know it’s an 
ArrayList. It could be a LinkedList. Or a special- 
ized type of List. Code that's working with the 
List only needs to know it can call List methods 
on it (like add(), size() etc). It's usually safer 

to pass the interface type (i.e., List) around 
instead of the implementation. That way, other 
code can't go rooting around inside your ob- 
ject in a way that was never intended. 


It also means that should you ever want to 
change from an ArrayList to a LinkedList, or a 
CopyOnWriteArrayList (see Chapter 18, Dealing 
with Concurrency Issues) at a later date, you can 
without having to change all the places the 
List is used. 
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ArrayList API 


Exploring the java.util API, List and Collections 


We know that with an ArrayList, or any List, the elements are kept in the order in which they were 
added. So we’re going to need to sort the elements in the song list. In this chapter, we’ll be looking 
at some of the most important and commonly used collection classes in the java.util package, but 

for now, let’s limit ourselves to two classes: java.util.List and java.util.Collections. 


We've been using ArrayList for a while now. Because ArrayList IS-A List and because many of the 


methods we’re familiar with on ArrayList come from List, we can comfortably transfer most of 
what we know about working with ArrayLists to List. 


The Collections class is known as a “utility” class. It’s a class that has a lot of handy methods for 
working with the various collection types. 


Excerpts from the API 


S . 


java.util. Collections 


S . 


7 


In the “Real-World’™ there are lots of ways to sort 


We don’t always want our lists sorted alphabetically. We might want to sort clothes by size, or 
movies by how many five-star reviews they get. Java lets you sort the good old-fashioned way, 
alphabetically, and it also lets you create your own custom sorting approaches. Those references you 


see above to “Comparator” have to do with custom sorting, which we'll get to later this chapter. So 
for now, let’s stick with “natural ordering” (alphabetical). 


Since we know we have a List, it looks like we’ve found the perfect method, Collections.sort(). 
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“Natural Ordering,’ what Java means by alphabetical 


Lou wants you to sort songs “alphabetically,” but what exactly does that mean? The A~Z part 

is obvious, but how about lowercase versus uppercase letters? How about numbers and special 
characters? Well, this is another can-of-worms topic, but Java uses Unicode, and for many of us 

in “the West” that means that numbers sort before uppercase letters, uppercase letters sort before 
lowercase letters, and some special characters sort before numbers and some sort after numbers. 
That’s pretty clear, right? Ha! Well, the upshot is that, by default, sorting in Java happens in what’s 
called “natural order,” which is more or less alphabetical. Let’s take a look at what happens when 
we sort our list of songs: 


public void go() { 
List<String> songList = MockSongs.getSongStrings (); 
System.out.printlin(songList) ; Sort our song, title 
Collections.sort(songList) ; L— “gtural ordering; 
System.out.printlin(songList) ; 


} 


s using, 


Our songs unsor bet 


: the 
in the order they 


%java Jukebox1 i wert added. 
[somersault, cassidy, $10, havana, Cassidy, 50 Ways] 


[$10, 50 Ways, Cassidy, cassidy, havana, somersault] ¢~—~_ 


Our Songs sorted. 
Notice how the special 
characters, numbers, 


and uppercase letters 
got sorted. 


Just FYI, we ducks are 
very particular about how we 
get sorted. 
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sorting your own objects 


But now you need Song objects, not just simple Strings 


Now your boss Lou wants actual Song class instances in the list, not just Strings, so that each Song can 
have more data. The new jukebox device outputs more information, so the actual song file will have 
three pieces of information for each song. 


The Song class is really simple, with only one interesting feature—the overridden toString() method. 
Remember, the toString() method is defined in class Object, so every class in Java inherits the method. 
And since the toString() method is called on an object when it’s printed (System.out.println(anObject)), 
you should override it to print something more readable than the default unique identifier code. When 
you print a list, the toString() method will be called on each object. 


class Songv2 { 


; for the 
ivate String title; instance variables : 
private String title Three insta i cibutes in the ‘ile. The variables ave all set in 


private 7 artist; tree song 4 the constructor whenever 
t t ; i 
private int bpm a new Sona is created. 


SongV2 (String title, String artist, int bpm) { 
this.title = title; 
this.artist = artist; 
this.bpm = bpm; 

} 

public String getTitle() { 


return title; The ated methods for 


: the three attributes. 


public String getArtist() { 
return artist; 


} do 
' ‘ hen you 
public int getBpm() { ; F 0, because W a 
return bpm; We override tS ona byet ee ig a 
a Syster-our rr ey you do 8 SYS EC a() 
‘ 7 “ the title. W en Y \\ the toString} 
public String toString() { aa to see Of Son = it calls ‘ak 
return title; println(alist ch pee an the list 
} method of EA 
} 
class MockSongs { 
public static List<String> getSongStrings() { ... } We made a new method in 
the MotkSongs class to 
public static List<SongV2> getSongsv2() { m 
List<SongV2> songs = new ArrayList<>() ; ock the new Song, data. 
songs.add(new SongV2("somersault", "zero 7", 147)); 


songs.add(new SongV2("cassidy", "grateful dead", 158)); 
songs.add(new SongV2("$10", "hitchhiker", 140)); 


songs.add(new SongV2("havana", "cabello", 105)); 
songs.add(new SongV2("Cassidy", "grateful dead", 158)); 


songs.add(new SongV2("50 ways", "simon", 102)); 
return songs; 


} 
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Changing the Jukebox code to use Songs 
instead of Strings 


Your code changes only a little. The big change is that the List will be 
of type <SongV2> instead of <String>. 


import java.util.*; 


public class Jukebox2 { 
public static void main(String[] args) { 
new Jukebox2().go(); 
} Change to 3 List of Sona\/? 
a eat ee 


objet 
public void go() { 


List<SongV2> songList = MockSongs.getSongsV2 () ; 


System.out.printin(songList) ; RK call the er tlass to a 
: \a Lis 

Collections.sort(songList) ; song, data into ou 

System.out.printlin (songlist) ; sonds- 


} 


And once again, call the 
sort method to sort the 


songs. 


I'm curious to see how the 
Collections.sort() method is 
going to sort these songs. 
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Collections.sort() 


It wont compile! 


He’s right to be curious, something’s wrong...the Collections class clearly shows 
there’s a sort() method that takes a List. It should work. 


But it doesn’t! 


The compiler says it can’t find a sort method that takes a List<SongV2>, so 
maybe it doesn’t like a List of Song objects? It didn’t mind a List<String>, so 
what’s the important difference between Song and String? What’s the difference 
that’s making the compiler fail? 


$javac Jukebox2. java 
Jukebox2.java:13: error: no suitable method found for 
sort (List<SongV2>) 


Collections.sort(songList) ; 
A 


1 error 


And of course you probably already asked yourself, “What would it be 
sorting on?” How would the sort method even Anow what made one Song 
greater or less than another Song? Obviously if you want the song’s tzéle 
to be the value that determines how the songs are sorted, you'll need 
some way to tell the sort method that it needs to use the title and not, say, 
the beats per minute. 


We'll get into all that a few pages from now, but first, let’s find out why 
the compiler won’t even let us pass a SongV2 List to the sort() method. 
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What is this??? I have no 
idea how to read the method 
declaration on this. It says that 
sort() takes a List<T>, but what 
is T? And what is that big thing 
before the return type? 


The sort() method declaration 


static(<T extends Comparable<? super T>>) void eee) list) 
tie 


Sorts peCitied list into ascending order, 
according to the natural ordering of its elements. 


From the API docs (looking up the java.util.Collections class and scrolling to the sort() method), it looks 
like the sort() method is declared...strangely. Or at least different from anything we’ve seen so far. 


That’s because the sort() method (along with other things in the whole collection framework in Java) 
makes heavy use of generics. Any time you see something with angle brackets in Java source code or 
documentation, it means generics—a feature added in Java 5. So it looks like we'll have to learn how to 
interpret the documentation before we can figure out why we were able to sort String objects in a List, 
but not a List of Song objects. 
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generic types 


Generics means more type-safety 


Although generics can be used in other ways, you'll often use generics to 
write type-safe collections. In other words, code that makes the compiler 
stop you from putting a Dog into a list of Ducks. 


Without generics the compiler could not care less what you put into a 
collection, because all collection implementations hold type Object. You 
could put anything in any ArrayList without generics; it’s like the ArrayList 
is declared as ArrayList<Object>. 


Before genevits, there was no 


. the type ok an 
WITHOUT generics annem « Ta) method 


Objects go IN as a reference to Nee type Object: 
SoccerBall, Fish, Guitar, and 
Car objects 


Without generics, the 
compiler would happily let 
you put a Pumpkin into 
an ArrayList that was 
| ArrayList supposed to hold only Cat 
objects. 
With generics, you 
And come OUT as a reference of type Object can create type-sake 
collections where more 
WITH generics problems are caught at 
Objects go IN as a reference to compile-time imstead of 
only Fish objects ) « & « runtime. 


HRN, 
PRY NS 


% GER ERROR 
‘ SO EIR Xrkn OD Eas RY ®) 
Wigs EOS igs 


7 GQ wrs 


And come out as a reference of type Fish 
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Learning generics 


Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 


@) Creating instances of generic classes (like ArrayList) 


When you make an ArrayList, you have to tell it the type of 
objects you'll allow in the list, just as you do with plain old 
arrays. 


@ Declaring and assigning variables of generic types 


How does polymorphism really work with generic types? If you 
have an ArrayList<Animal> reference variable, can you assign an 
ArrayList<Dog> to it? What about a List<Animal> reference? 
Can you assign an ArrayList<Animal> to it? You'll see... 


Declaring (and invoking) methods that take generic types 


If you have a method that has as a parameter, say, an ArrayList 
of Animal objects, what does that really mean? Can you also 
pass it an ArrayList of Dog objects? We'll look at some subtle 
and tricky polymorphism issues that are very different from the 
way you write methods that take plain old arrays. 


(This is actually the same point as #2, but that shows you how 
important we think it is.) 


there are no 


Dumb Questions 


Q: But don’t | also need to learn how to create my OWN generic 
classes? What if | want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 


A: You probably won't do much of that. Think about it—the API 
designers made an entire library of collections classes covering most 
of the data structures you'd need, and the things that really need to be 
generic are collection classes or classes and methods that work on col- 
lections. There are some other cases too (like Optional, which we'll see 
in the next chapter). Generally, generic classes are classes that hold or 
operate on objects of some other type they don’t know about. 


Yes, it is possible that you might want to create generic classes, but that’s 
pretty advanced, so we won't cover it here. (But you can figure it out 
from the things we do cover, anyway.) 
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new ArrayList<Song>() 


List<Song> songList = 
new ArrayList<Song> () 


void foo(List<Song> list) 


x. £00 (songList) 
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Using generic CLASSES 


Since ArrayList is one of our most-used generic classes, we'll 
start by looking at its documentation. The two key areas to 
look at in a generic class are: 


1. The class declaration 


2. The method declarations that let you add elements 


Understanding ArrayList documentation 
(Or, what’s the true meaning of “E”?) 


\der for the Arra List. 
oe” isa placeho aces YEIst is 9 subélass £ 
TENE REE Sweat Aram” pe You apn fy rset 
lu ; e 
declare am EYP oF the Abstrneh SY Wed for dy 
public class ArrayList<E> extends AbstractList<E> implements List<E> ... { 


blic bool dd(E 
aici i The type (the value of <E>) 
becomes the type of the List 


Here’s the important part! Whatever “E” is slecfite aowul 


determines what kind of things you're allowed 
to add to the ArrayList: 


// more code 


Think of “E” as a stand- 


The “E” represents the type used to create an instance mn for “the type of element 
of ArrayList. When you see an “E” in the ArrayList 


documentation, you can do a mental find/replace to exchange you want this collection to 


. . . . ; i 
it for whatever <type> you use to instantiate ArrayList. hold and return.’ (E 1S for 
So, new ArrayList<Song> means that “E” becomes “Song” in _ 

any method or variable declaration that uses “E.” Element.) 
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Using type parameters with ArrayList 


THIS code: 


List<String> thisList = new ArrayList<> 


Means ArrayList: 


public class ArrayList<E>| extends AbstractList<E> ... { 


public boolean add(E 0) 
// more code 


Is treated by the compiler as: 


public class ArrayList<String> extends AbstractList<String>... { 


public boolean add(String 0) 
// more code 


In other words, the “E” is replaced by the zeal type (also called the type parameter) that 
you use when you create the ArrayList. And that’s why the add() method for ArrayList 
won't let you add anything except objects of a reference type that’s compatible with 
the type of “E.” So if you make an ArrayList<String>, the add() method suddenly 
becomes add (String o). If you make the ArrayList of type Dog, suddenly the add() 
method becomes add(Dog o). 


there are no 


Dumb Questions 


Q: Is “E” the only thing you can put there? Because the docs for sort used “T”... 


A: You can use anything that’s a legal Java identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But you'll often 
see single letter used. Another convention is to use “T” (“Type”) unless you're specifically 
writing a collection class, where you'd use “E” to represent the “type of the Element the 
collection will hold.” Sometimes you'll see “R” for “Return type.” 


you are here > 
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Using generic METHODS 


A generic class means that the class declaration includes a type parameter. A 


generic method means that the method declaration uses a type parameter in 
its signature. 


You can use type parameters in a method in several different ways: 


@ 
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Using a type parameter defined in the class declaration 


public class ArrayList<E> extends AbstractList<E> ... { 


public boolean add(E o) Se Can use the “p” h 
already been de fined a et! b 


eCause it’s 


the 
When you declare a type parameter for the class, you can class. 


simply use that type any place that you’d use a veal class or 
interface type. The type declared in the method argument 
is essentially replaced with the type you use when you 
instantiate the class. 


Using a type parameter that was NOT defined in the 


class doctor St 08 ey 


public <T extends Animal> void takeThing (ArrayList<T> list) 


If the class itself doesn’t use a type parameter, you can still Here 
specify one for a method, by declaring it in a really unusual (but 
available) space—before the return type. This method says that T declaration, 
can be “any type of Animal.” 


chapter 11 


we a, 
the start f i 


> beCause we 
e method 


declared 
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Wait...that can't be right. If you can 
take a list of Animal, why don't you 

just SAY that? What's wrong with just 
takeThing(ArrayList<Animal> list)? 


Here's where it gets weird... 


This: 
public <T extends Animal> void takeThing(ArrayList<T> list) 


Is NOT the same as this: 
public void takeThing (ArrayList<Animal> list) 


Both are legal, but they’re different! 


The first one, where <T extends Animal> is part of the method 
declaration, means that any ArrayList declared of a type that is 
Animal, or one of Animal’s subtypes (like Dog or Cat), is legal. 

So you could invoke the top method using an ArrayList<Dog>, 
ArrayList<Cat>, or ArrayList<Animal>. 


But...the one on the bottom, where the method argument is 
(ArrayList<Animal> list) means that only an ArrayList<Animal> is 
legal. In other words, while the first version takes an ArrayList of any 
type that is a type of Animal (Animal, Dog, Cat, etc.), the second 
version takes only an ArrayList of type Animal. Not ArrayList<Dog> 
or ArrayList<Cat>, but only ArrayList<Animal>. 


And yes, it does appear to violate the point of polymorphism, but 
it will become clear when we revisit this in detail at the end of the 
chapter. For now, remember that we’re only looking at this because 
we're still trying to figure out how to sort() that SongList, and that 
led us into looking at the API for the sort() method, which had this 
strange generic type declaration. 


For now, all you need to know is that the syntax of the 
top version is legal and that it means you can pass in a 
ArrayList object instantiated as Animal or any Animal 
subtype. 


And now back to our sort() method... 
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sorting a Song 


This still doesn't explain why 
the sort method failed ona 

List of Songs but worked for a 
List of Strings... 


Remember where we were... 


Sjavac Jukebox2. java 
Jukebox2.java:13: error: no suitable method found 
for sort (List<SongvV2>) 

Collections.sort(songList) ; 


Aa 


import java.util.*; 
public class Jukebox2 { 
public static void main(String[] args) { 
new Jukebox2().go(); 
} 
public void go() { 


List<SongV2> songList = MockSongs.getSongsV2 () ; 


System.out.printlin(songList) ; 
e 
This is where it breaks! eee — _ 
: : : 
Collections.sort(songList) ; assed in a List<String> | : ; af 
System.out.printlin(songList) ; . ka List<SonaV/2>, : 


} 
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Revisiting the sort() method 


So here we are, trying to read the sort() method docs to find out why 
it was OK to sort a list of Strings, but not a list of Song objects. And 
it looks like the answer 1s... 


static¢<T extends Comparable<? super T>> void sort(List<t} list) 
t ra 


Sorts specified list into ascending order, 
according to the natural ordering of its elements. 


The sort() method can take only lists of Comparable objects. 


Song is NOT a subtype of Comparable, so you cannot sort() the 
list of Songs. 


At least not yet... 


public static <T extends Comparable<? super T>> void sort(List<T> list) 


"en tw ‘ 


lanore this part for now But i 
: ) . 1 List lor 
“Whatever ‘T’ is must ara can't, it just mea You ean caer i 
ie me re Compare? that the type prance: Oe subtype of iets Whe Dera 


meterized type 
Comparable must be of type T that uses a para eterized ty 
or one of T’s TAN that “extends Comparable. 


Um...I just checked the docs for 
String, and String doesn't EXTEND 
Comparable—it IMPLEMENTS it. Comparable 
is an interface. So it's nonsense to say <T 
extends Comparable>. 


public final class String 
implements java.io.Serializable, Comparable<String>, CharSequence { 


Great point, and one that deserves a full answer! Turn the 
page... 
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extends or implements 


In generics, ‘extends’ means 
‘extends or implements” 


The Java engineers had to give you a way to put a constraint on a 
parameterized type so that you can restrict it to, say, only subclasses 


of Animal. But you also need to constrain a type to allow only classes In generics, the Kkeyw ord 
that implement a particular interface. So here’s a situation where we “extends” really means 9- AN” 


need one kind of syntax to work for both situations—inheritance 


and implementation. In other words, that works for both extends and and works for BOT H classes 
implements. : 
and interfaces. 


And the winning word was...extends. But it really means “IS-A’ and 
works regardless of whether the type on the right is an interface or a 
class. 
Comparable is an interface, so this 
REALLY veads, “T must be a type that 
implements the Comparable intertace- 


L 


public static <T extends Comparable<? super T>> void sort(List<T> list) 


It doesn’t matter whether the thing on the right is 
a élass or interface...you still say “extends.” 


there, are_no 


Dumb Questions 


Q: Why didn’t they just make a new keyword, “is”? 


A: Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version. Think about it— 
you might be using a variable “is” (which we do use in this book to represent 
input streams). And since you're not allowed to use keywords as identifiers 
in your code, that means any earlier code that used the keyword before it 
was a reserved word, would break. So whenever there’s a chance for the 
language engineers to reuse an existing keyword, as they did here with 
“extends,” they'll usually choose that. But sometimes they don’t have a 
choice. 


In recent years, new “keyword-like” terms have been added to the language, 
without actually making it a keyword that would trample all over your earlier 
code. For example, the identifier var, which we'll talk about in Appendix B, 
is a reserved type name, not a keyword. This means any existing code that 
used var (for example, as a variable name) will not break if it’s compiled with 
a version of Java that supports var. 
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Finally we know what’s wrong... 


The Song class needs to implement Comparable 


We can pass the ArrayList<Song> to the sort() method only if the Song 


class implements Comparable, since that’s the way the sort() method 
was declared. A quick check of the API docs shows the Comparable 
interface is really simple, with only one method to implement: 


java.lang.Comparable 


public interface Comparable<T> { 
int compareTo(T 0); 


} 


And the method documentation for compareTo() says: 


Returns: 

a negative integer if this object is 
less than the specified object; 

a zero if they’re equal; 

a positive integer if this object is 
greater than the specified object. 


It looks like the compareTo() method will be called on one Song 
object, passing that Song a reference to a different Song, The Song 
running the compareTo() method has to figure out if the Song it 
was passed should be sorted higher, lower, or the same in the list. 


Your big job now is to decide what makes one song greater 

than another, and then implement the compare To() method to 
reflect that. A negative number (any negative number) means 

the Song you were passed is greater than the Song running the 
method. Returning a positive number says that the Song running 
the method is greater than the Song passed to the compareTo() 
method. Returning zero means the Songs are equal (at least for 
the purpose of sorting...1t doesn’t necessarily mean they’re the 
same object). You might, for example, have two Songs by different 
artists with the same title. 


(That brings up a whole different can of worms we'll look at 
later...) 
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The big question is: what 
makes one song less than, 
equal to, or greater than 
another song? 


You can’t implement the 
Comparable interface until you 
make that decision. 


Ge sharpen your pencil 
een yer p 


Write in your idea and pseudocode (or 
better, REAL code) for implementing the 
compareTo() method in a way that will 
sort() the Song objects by title. 


Hint: if you're on the right track, it should 
take less than three lines of code! 


—-+> Yours to solve. 
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The new, improved, comparable Song class 


We decided we want to sort by title, so we implement the compare To() 
method to compare the title of the Song passed to the method against the 
title of the song on which the compareTo() method was invoked. In other 
words, the song running the method has to decide how its title compares to 
the title of the method parameter. 


Hmmm...we know that the String class must know about alphabetical order, 

because the sort() method worked on a list of Strings. We know String has 

a compare [o() method, so why not just call it? That way, we can simply let 

one title String compare itself to another, and we don’t have to write the 

comparing/alphabetizing algorithm! Usually these match...we're speci fying the type that 
the implementing class can be Compared against. 


This means that SongV3 ae can be compared to 
— OS other SongV/3 objects, for the purpose of sorting, 
class SongV3 implements Comparable<SongV3> { 

private String title; 


Private String artist; The sort) method sends a Sono, to compare Tol) 
private int bpm; —_ to see how that Song compares to the Song on 
which the method was invoked. 
public int compareTo(SongV3 s) { S ' 
return title.compareTo(s.getTitle()) ; : a as ist fas te. wee 
_——— e i : 

| | | | Since we know Sty, ah sees 

SongV3 (String title, String artist, int bpm) { Compare To() method ave a 


this.title = title; 
this.artist = artist; 
this.bpm = bpm; 

} 


public String getTitle() { 
return title; 


| This time it worked. [t prints the list and then calls 


public String getArtist() { sort, which puts the Songs in alphabetical order by title 
return artist; 
} 


$java Jukebox3 


public int getBpm() { 2 3 
eeburk bem [somersault, cassidy, $10, havana, Cassidy, 50 


} ways] 


[$10, 50 ways, Cassidy, cassidy, havana, somer- 
sault] 


public String toString() { 
return title; 


} 
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We can sort the list, but... 


There’s a new problem—Lou wants two different views of the song list, one 
by song title and one by artist! 


But when you make a collection element comparable (by having it 


implement Comparable), you get only one chance to implement the 
compare To() method. So what can you do? 


The horrible way would be to use a flag variable in the Song class and 
then do an # test in compareTo() and give a different result depending on 
whether the flag is set to use title or artist for the comparison. 


But that’s an awful and brittle solution, and there’s something much better. 
Something built into the API for just this purpose—when you want to sort 
the same thing in more than one way. 


Look at API documentation again. There’s a second 
sort() method on Collections—and it takes a 
Comparator. There’s also a sort method on List that 
takes a Comparator. 


Excerpts from the API 


util.Collections . 
sort et Sorts the specified list into ascending order, accord 


sort(List Comparator): Sorts the specified list according to the 


sava.util.List . . 
<ort(Comparator) Sorts this list according 


ing to the natural ordering of its elements. 


order induced by the specified Comparator. 


to the order induced by the specified Comparator. 


collections with generics 


That's not good enough. 
Sometimes I want it to sort 
by artist instead of title. 


S 
fe) 


1, glso + /make 
ake Ver load. d Theres 3 Lists ovt how to 9¢ 
a coe ome ing call ie cork) caves a Note to self oe are and order 
its ng Oe Lor that can Com: 4 
nav a Lom : e 
es the songs by artist wnstead 
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Using a custom Comparator 


A Comparable element in a list can compare ttself 

to another of its own type in only one way, using its 
compareTo() method. But a Comparator is external to the 
element type you’re comparing—it’s a separate class. So you 
can make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BpmComparator. 


Then all you need to do is call a sort() method that takes a 
Comparator (Collections.sort or List.sort), which will use this 
Comparator to put things in order. 


The sort() method that takes a Comparator will use the 
Comparator instead of the element’s own compare To() 
method when it puts the elements in order. In other words, if 
your sort() method gets a Comparator, it won’t even call the 
compareTo() method of the elements in the list. The sort() 
method will instead invoke the compare() method on the 
Comparator. 


To summarize, the rules are: 


) Invoking the Collections.sort(List list) method 
means the list element’s compareTo() method 
determines the order. The elements in the list MUST 
implement the Comparable interface. 


) Invoking List.sort(Comparator c) or 
Collections.sort(List list, Comparator c) means 
the Comparator's compare() method will be 
used. That means the elements in the list do NOT 
need to implement the Comparable interface, 
but if they do, the list element's compareTo() 
method will NOT be called. 


java.util.Comparator 


public interface Comparator<T> { 
int compare(T 01, T 02); 


} 


If you pass a Comparator to the 
sort() method, the sort order is 
determined by the Comparator. 


If you don’t pass a Comparator 
and the element is Comparable, the 
sort order is determined hy the 
element’s compare To() method. 


there, are_no 


Dumb Questions 


Q: 


Why are there two sort methods that take a comparator on two 


different classes? Which sort method should | use? 


A: Both methods that take a comparator, Collections.sort(List, Compara- 
tor) and List.sort(Comparator), do the same thing; you can use either and 
expect exactly the same results. 


List.sort was introduced in Java 8, so older code must use Collections. 
sort(List, Comparator). 


We use List.sort because it’s a bit shorter, and generally you already have the 
list you want to sort, so it makes sense to call the sort method on that list. 
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Updating the Jukebox to use a Comparator 


We're going to update the Jukebox code in three ways: 


1. Create a separate class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTo/()). 


2. Make an instance of the Comparator class. 


3. Call the List.sort() method, giving it the instance of the Comparator class. 


import java.util.*; 


public class Jukebox4 { 
public static void main(String[] args) { 
new Jukebox4().go(); 
} 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3(); 


System.out.printlin(songList) ; Make an ndbante at the 


ss. 
Collections.sort(songList) ; Comparator cla 


System.out.printlin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare() ; pete sort() on our list, Passin 
songList.sort (artistCompare) ; i C a reference to the new peicl 
System.out.println(songList) ; omParator object. 

} 


class ArtistCompare implements Comparator<SongV3> { 


public int compare (SongV3 one, SongV3 two) { We're letting the Strin 
return one.getArtist() .compareTo(two.getArtist()) ; variables (Loy artist) do 
} _—__ — the actual Comparison, 
} This is a String (the artist) i Strings already 
now how alphabetize 
hemselves. 
List 
yn" 
$java Jukebox4 Unsorted _ 
[somersault, cassidy, $10, havana, Cassidy, 50 ways] fan 
‘ sin 
[$10, 50 ways, Cassidy, cassidy, havana, somersault] Sorted bY ecto metho ) 
Songs Com 
[havana, Cassidy, cassidy, $10, 50 ways, somersault] i 
Sor. 
db 
us a 
4Sing Arbestn st Name 
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exercise: sharpen your pencil 


ote your pencil Fill-in-the-blanks 


For each of the questions below, fill in the blank 
with one of the words from the “possible answers” 
list, to correctly answer the question. 


Possible Answers: 
Comparator, 
Comparable, 
compareTo( ), 
compare( ), 

yes, 
no 


Given the following compilable statement: 


Collections.sort(myArrayList) ; 


1. What must the class of the objects stored in myArrayList implement? 


2. What method must the class of the objects stored in myArrayList implement? 


3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 


Given the following compilable statements (they both do the same thing): 


Collections.sort(myArrayList, myCompare) ; 
myArrayList.sort (myCompare) ; 


4. Can the class of the objects stored in myArrayList implement Comparable? 


5. Can the class of the objects stored in myArrayList implement Comparator? 


6. Must the class of the objects stored in myArrayList implement Comparable? 


7. Must the class of the objects stored in myArrayList implement Comparator? 


8. What must the class of the myCompare object implement? 


9. What method must the class of the myCompare object implement? 


————> Answers on page 364. 
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But wait! We're sorting in two different ways! 


Now we’re able to sort the song list two ways: 


1. Using Collections.sort(songList), because Song implements Comparable 
2. Using songLists.sort(artistCompare) because the ArtistCompare class implements Gomparator 


While our new code allows us to sort songs by title and by artist, it is reminiscent of Frankenstein’s monster, 
cobbled together bit by bit. 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3 () ; 
System.out.printlin(songList) ; This. uses Comparable to sort 


Collections.sort(songList) ; 
System.out.printlin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare(); 


songList.sort (artistCompare) ; . 
a This uses 9 custom 


System.out.printin(songList) ; 
’ Comparator to sort 


A better approach would he to handle 
all of the sorting definitions in classes 
that implement Comparator. 


there, are_no 


Dumb Questions 


Q: So does this mean that if you have a class that Q: But why doesn’t every class implement Comparable? 
doesn’t implement Comparable, and you don’t have the 

source code, you could still put the things in order by A 
creating a Comparator? 


- Do you really believe that everything can be ordered? 
If you have element types that just don’t lend themselves to 
A: any kind of natural ordering, then you'd be misleading other 
* That’s right. The other option (if it’s possible) would be programmers if you implement Comparable. And there's no 
to subclass the element and make the subclass implement problem if you don’t implement Comparable, since a programmer 
Comparable. can compare anything in any way that they choose using their 
own custom Comparator. 
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Sorting using only Comparators 


Having Song implement Comparable and creating a custom Comparator for sorting by Artist absolutely works, 
but it’s confusing to rely on two different mechanisms for our sort. It’s much clearer if our code uses the same 
technique to sort, regardless of how Lou wants his songs sorted. The code below has been updated to use 
Comparators for sorting by both Title and Artist; the new code is in bold. 


public class Jukebox5 { 
public static void main(String[] args) { 
new Jukebox5().go(); 


public void go() { 
List<SongV3> songList = MockSongs.getSongsV3(); 
System.out.printin(songList) ; 
Make an instante of the 
TitleCompare titleCompare = new TitleCompare() ; Comparator tlass and use the 
songList.sort(titleCompare) ; sort) method on List. 
System.out.printin(songList) ; 


ArtistCompare artistCompare = new ArtistCompare(); 
songList.sort (artistCompare) ; ; 
System.out.printin(songList) ; This is the new élass that 
} implements Comparator. 
} 
class TitleCompare implements Comparator<SongV3> { 
public int compare (SongV3 one, SongV3 two) { 
return one.getTitle() .compareTo (two.getTitle() ); 
} 
} 
class ArtistCompare implements Comparator<SongV3> { 
public int compare (SongV3 one, SongV3 two) { 
return one.getArtist().compareTo(two.getArtist()); 


// more specialized Comparator classes could go here, © 


// e.g. BpmCompare 
D 


That's an awful lot of 
code for sorting our songs 
in just two different orders. 
Isn't there a better way? 
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Just the code that matters 


The Jukebox class does have a lot of code that’s needed for sorting. Let’s zoom in on one 
of the Comparator classes we wrote for Lou. The first thing to notice is that all we really 
want to sort our collection is the one line of code in the middle of the class. The rest of 
the code is just the long-winded syntax that’s necessary to let the compiler know what 
type of class this is and which method it implements. 


Code Up Clase 


The one line of code that’s 
doing, all the work 


class TitleCompare implements Comparator<Song> { 
public int compare(Song one, Song two) { 
return one.getTitle() .compareTo(two.getTitle()); 


There’s more than one way to declare small pieces of functionality like this. One 
approach is inner classes, which we’ll look at in a later chapter. You can even 
declare the inner class right where you use it (instead of at the end of your class 
file); this is sometimes called an “argument-defined anonymous inner class.” Sounds 
fun already: 


songList.sort(new Comparator<SongV3>() { Ta, Relax 


public int compare (SongV3 one, SongV3 two) { We're not 


return one.getTitle() .compareTo(two.getTitle()); going to learn 
} how to write 


he “argument-defined anony- 
, 
mous inner classes”! 


We just wanted you to 
see this example, in case 
you stumble across it in Real Code. 


While this lets us declare the sorting logic in exactly the location we 
need it (where we call the sort method, instead of in a separate class), 
there’s still a lot of code there for saying “sort by title please”). 
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the compiler already knows 


What do we REALLY need in order to sort? 


public class Jukebox5 { The compiler knows — 
public void go() { contains Song objets: 
List<SongV3> songList = MockSongs.getSongsV3(); 


TitleCompare titleCompare = new TitleCompare(); 
songList.sort (titleCompare) ; 


The Compi 


ler onder sta 
ree Ns eS nds that 
} Sng yet an ‘. Comparator foy- 


} 
class TitleCompare implements Comparator<SongV3> { 
public int compare (SongV3 one, SongV3 two) { 
return one.getTitle().compareTo(two.getTitle()); 
} 
} 


Let’s take a look at the API documentation for the sort method on List: 


default void sort(Comparator<? super E> c) Sorts this list according to the order 
induced by the specified Comparator. 


If we were to explain out loud the following line of code: 


songList.sort (titleCompare) ; 


We could say: 


“Call the sort method on the list of songs 1) and pass ita 
reference to a Comparator object, which is designed specifically 
to sort Song objects @.” 

If we’re honest, we could say all that without even looking at the ‘TitleCompare class. 


We can work it all out just by looking at the documentation for sort and the type of the 
List that we’re sorting! 


=) 
i 


Do you think the compiler cares about the name 
“TitleCompare’”? If the class was called “FooBar” 
instead, would the code still work? 


©) 
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Wouldn't it be wonderful 

if the code that described HOW 
you want to sort your Songs 
wasn't so far away from the 

sort method? And wouldn't it be 
great if you didn't have to write a 
bunch of code the compiler could 
probably figure out on its own... 
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lambda expressions 


Enter lambdas! Leveraging what the compiler can infer 


We could write a whole bunch of code to say how to sort a list (like 

we have been doing)... This is just a reference to an object th 

ae Implements Comparator. [ts name ri 
matter to the Compiler. = 


songList.sort (titleCompare) ; 


The Compiler i D 
h! The compi 
not a whit on’ the ompiler tan infe thi 
call the one ye oo the sort() does. r this from 


class TitleCompare implements Comparator<Song> { The Compiler ean f; 


out that the two cia 


,_ 
Yup, the ecree CN Oe 5 a have to be Son i 


knows what this Public int compare(Song one, Song two) { ries songList isa List of 
method should ong objects. 
look like. return one.getTitle() .compareTo(two.getTitle() ); 


ae i 


os This is ALL THE COMPILER NEED¢. 


Just tell it HOW to do the sort! 


Or, we could use a lambda... we 
, ne 


songList.sort((one, two) -> one.getTitle() .compareTo(two.getTitle())); 


Or Barbell 


What do you think would happen if Comparator 
needed you to implement more than one method? 


How much could the compiler fill in for you? 
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Where did all that code go? 


To answer this question, let’s take a look at the API documentation 
for the Comparator interface. 


Method Summary 
Modifier and Type Method Description 
int compare(T ol, T 02) Compares its two arguments for order. 
boolean equals(Object obj) Indicates whether some other object is 


"equal to" this comparator. 


Because equals has been implemented by Object, if we create a 
custom comparator, we know we only need to implement the compare 
method. 


We also know exactly the shape of that method—1it has to return an inherits ™ hh equals is 
int, and it takes two arguments of type T (remember generics?). Our Objet zi 4 in class Object 
lambda expression implements the compare() method, without having immplemenvé 

to declare the class or the method, only the details of what goes into 

the body of the compare() method. 


Some interfaces have only ONE 
method to implement 


With interfaces like Comparator, we only have to implement a single 
abstract method, SAM for short. These interfaces are so important that 
they have several special names: 


SAM Interfaces axk.a. Functional Interfaces 


If an interface has only one method that needs to be implemented, that 
interface can be implemented as a lambda expression. You don’t need 
to create a whole class to implement the interface; 

the compiler knows what the class and method 


would look like. What the compiler doesn’t know . 4 
is the logic that goes mside that method. te. ax 


We'll look at lambda expressions 
and functional interfaces in much 
more detail in the next chapter. For now, 


back to Lou’s diner. 
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sorting with lambdas 

Updating the Jukebox code with lambdas 
import java.util.*; 
public class Jukeboxé { 


public static void main(String[] args) { 
new Jukebox6().go(); 


public void go() { 


I : t<Son gV3> songl . t = Moc kSongs g tSo gsv 0) 
System.out ie . tln (son I : ) -ge n 3 . - 
Kev s ow lambda enn ession m at yon—No 

e€ 
soruUn' \ ie rl h insidi sov mm hod t 


songList.sort((one, two) -> one.getTitle() .compareTo(two.getTitle() )); 


—_—_ —~ 
System.out.printin(songList) ; ee a 
You can tell what the list will be sorted by, just 
by looking, at the Field used in the lambda. 
eat = 
songList.sort((one, two) 


-> one.getArtist() .compareTo (two.getArtist())); 
System.out.printin(songList) ; 


} File Edit_Window Help Ambient 


$java Jukebox6 


The output is areas [somersault, cassidy, $10, havana, Cassidy, 50 ways] 
bana ysed Comparator classes, 
WwW 


ode was much shorter: [$10, 50 ways, Cassidy, cassidy, havana, somersault] 
but our Code Ww 


[havana, Cassidy, cassidy, $10, 50 ways, somersault] 


eon you pecl How could you sort the songs differently? 


Write lambda expressions to sort the songs in these ways (the 
answers are at the end of the chapter): 


* Sort by BPM | 
= Sort by title in descending order ois on 
page 366. 
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etep yur paul Reverse Engineer 


Assume this code exists in a single file. Your job is 
to fill in the blanks so the program will create the 
output shown. 


import 


public class SortMountains { 
public static void main(String [] args) { 
new SortMountains() .go() ; 


} 


public void go() { 
List mountains = new ArrayList<>() ; 
mountains .add(new Mountain("Longs", 14255)); 
mountains .add(new Mountain ("Elbert", 14433)); 
mountains .add(new Mountain("Maroon", 14156)); 
mountains .add(new Mountain("Castle", 14265)); 
System.out.println("as entered:\n" + mountains) ; 


mountains. ( -> ); 
System.out.println("by name:\n" + mountains) ; 


ee Seeeerey, | ->_ 
System.out.println("by height:\n" + mountains) ; 


} 


class Mountain { 


{ 
} SSS Output: 
{ 
Sjava SortMountains 
} as entered: 
: [Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 
by name: 
[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 
[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
————> Answers on page 365. 


youarehere> 343 


dealing with duplicates 


Uh-oh. The sorting all works, but now we have duplicates... 


The sorting works great; now we know how to sort on both ééle and artist. But there’s a new problem 
we didn’t notice with a test sample of the jukebox songs—the sorted list contains duplicates. 


Unlike the mock code, Lou’s real jukebox application appears to just keep writing to the file 
regardless of whether the same song has already been played (and thus written) to the text file. The 
SongListMore. txt jukebox text file is an example. It’s a complete record of every song that was played, 
and might contain the same song multiple times. 


Sjava Jukebox7 


[somersault: zero 7, cassidy: grateful dead, $10: hitchhiker, Before sorting 
havana: cabello, $10: hitchhiker, cassidy: grateful dead, 50 
ways: simon] 


After sorting by 
[$10: hitchhiker, $10: hitchhiker, 50 ways: simon, cassidy: song title 
grateful dead, cassidy: grateful dead, havana: cabello, 
somersault: zero 7] 
[havana: cabello, cassidy: grateful dead, cassidy: grateful 
dead, $10: hitchhiker, $10: hitchhiker, 50 ways: simon, After sorting by 
somersault: zero 7] artist name 
Note that 
Song's taSbring (284 ve 
title and the uk put the 
SongListMore. txt 
The Sonali 
a: £ the actual somersault, zero 7, 147 : N) istMove te + £; 
be ica looks like. cassidy, grateful dead, 158 duplicates in it, betinse Pedr = 
aie $10, hitchhiker, 140 machine is writing every gogo ebox 
havana, cabello, 105 in order. reg Played, 
$10, hitchhiker, 140 To get 
cassidy, grateiut dead, 158 a Foceine tet om we wrote 
50 ways, simon, 102 getSongs() method thetrtt a 
I the eturned g 
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We need a Set instead of a List 


From the Collection API, we find three main interfaces, List, Set, and Map. 
ArrayList is a List, but it looks like Set is exactly what we need. 


Duplicates OK. 


>» LIST - when sequence matters 
Collections that know about index position. 


Lists know where something is in the list. You 
can have more than one element referencing 
the same object. 


> SET - when uniqueness matters NO duplicates. 
Collections that do not allow duplicates. 


Sets know whether something is already in the collection. 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal—we'll look at what 
object equality means in a moment). 


> MAP - when finding something by key matters 
Collections that use key-value pairs. 
Maps know the value associated with a given key. You 


can have two keys that reference the same value, but you 
cannot have duplicate keys. A key can be any object. 
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the collections API 


The Collection API (part of it) 


Notice that the Map interface doesn’t actually 
extend the Collection interface, but Map 

is still considered part of the “Collection 
Framework” (also known as the “Collection 


API”). So Maps are still collections, even . 
though they don’t include java.util.Collection pellecnon 
ace i ee (interface) 


in their inheritance tree 


(Note: this is not the complete 


collection API; there are other 


classes and interfaces, but 
these are the ones we care 
most about.) 


Set List 
(interface) (interface) 
a fs i Ly 


oh 
1 
! \ 
Uy \ 
! ‘ 
SortedSet : \ i \ \ 
- 1 
(interface) H \ ‘ 
H 
I 
! 
! 
t 


rT 
ul 
ul 
! \ x 
a 
a 
ri 
t 


TreeSet | timo HashSet “| ArrayList LinkedList Vector 


KEY 
T extends Mars don "£ extend from 
th : javaw util.Colleetion, but 
: implements they're still considered 
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a” K still referred to as a 
\ ‘ colleetion. 


Map to be part of the 
j Collection Framework 
_ amnarece) | in Java. So a Mar is 


SortedMap \ * 


(interface) 


TreeMap : HashMap enol Hashtable 
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Using a HashSet instead of ArrayList 


We updated the Jukebox code to put the songs in a HashSet to try to eliminate our duplicate 
songs. (Note: we left out some of the Jukebox code, but you can copy it from earlier versions.) 


import java.util.*; 


public class Jukeboxs { i vecuen a 
public static void main(String[] args) { Sonos class ° khe sarne 
. M ekMore tain 
new Jukebox8().go(); int eated 3 ee ke that Con 
} aa VV ovye 
List of Send ListiMore 
— s 
public void go() { values 3 
List<SongV3> songList = MockMoreSongs.getSongsV3 () ; 
System.out.printlin(songList) ; 
songList.sort((one, two) -> one.getTitle() .compareTo(two.getTitle())); 
System.out.printlin(songList) ; 
Set<SongV3> songSet = new HashSet<>(songList) ; 
System.out.println(songSet) ; 
} CF ttashset has a Constructor that takes a 
} rl Collection, and it will create a set with all th 
We want the Set to hold SongV items from that tollection. e 


obietts. HashSet IS—A Set, so we can 
store the HashSet in this Set variable. 


File Edit Window Help GetBetterMusic 


Sjava Jukebox8 Before sorting 
the List. 
[somersault, cassidy, $10, havana, $10, cassidy, 50 ways] 
After sorting the 
[$10, $10, 50 ways, cassidy, cassidy, havana, somersault] List (by title). 


[$10, 50 ways, havana, cassidy, $10, cassidy, somersault] 


After putting it 
into a HashSet 


(And it lost its sort order and printing the 


idn’ f he list into a HashSet (we didn t 
. wale ne ee ey about tall sort() again). 


We still have all the duplicates! that one later. 
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object equality 


What makes Two Objects equal? If two objects foo and bar are 
equal, foo.equals(bar) and 

bar.equals(foo) must be true, 
and both foo and bar must re- 


ied (iett Get “Se I bj turn the same value from 
considered equal. Is 1t simply two references to the very same object, hashCode(). For a Set to treat 


or 1s it two separate objects that both have the same tile? 


To figure out why using a Set didn’t remove the duplicates, we have 
to ask—what makes two Song references duplicates? They must be 


two objects as duplicates, you 

must override the hashCode() 

and equals() methods inherited 

P from class Object so that you 

>» Reference equality can make two different objects 
Two references, one object on the heap. be viewed as equal. 


This brings up a key issue: reference equality vs. object equality. 


Two references that refer to the same object on the heap are equal. 
Period. If you call the hashCode() method on both references, you'll 
get the same result. If you don’t override the hashCode () method, 
the default behavior (remember, you inherited this from class Object) 
is that each object will get a unique number (most versions of Java 
assign a hashcode based on the object's memory address on the 
heap, so no two objects will have the same hashcode). 


If you want to know if two references are really referring to the same 
object, use the == operator, which (remember) compares the bits in 

the variables. If both references point to the same object, the bits will 
be identical. 


Song 
if (songl == song2) { 


// both references are referring 
// to the same object on the heap 


> Object equality 


Two references, two objects on the heap, but the 
objects are considered meaningfully equivalent. 


If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must override both the hashCode() 
and equals() methods inherited from class Object. 


As we said above, if you don’t override hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCode() to be sure that two 
equivalent objects return the same hashcode. But you must also 


Son 
override equals() so that if you call it on either object, passing in 9 
the other object, always returns true. 
if (songl.equals(song2) && songl.hashCode() == song2.hashCode()) { 


// both references are referring to either a 


// a single object, or to two objects that are equal 
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How a HashSet checks for duplicates: hashCode() and equals() 


When you put an object into a HashSet, it calls the 
object’s hashCode method to determine where to put 
the object in the Set. But it also compares the object’s 
hash code to the hash code of all the other objects in 
the HashSet, and if there’s no matching hash code, the 
HashSet assumes that this new object is not a duplicate. 


In other words, if the hash codes are different, the 
HashSet assumes there’s no way the objects can be equal! 


So you must override hashCode() to make sure the objects 
have the same value. 


But two objects with the same hash code might not be 
equal (more on this on the next page), so if the HashSet 


I need to know 
if your hashCode() 
values are the same. 


finds a matching hash code for two objects—one you’re 
inserting and one already in the set—the HashSet will 
then call one of the object’s equals() methods to see if 
these hash code—matched objects really are equal. 


And if they’re equal, the HashSet knows that the object 
you're attempting to add is a duplicate of something in the 
Set, so the add doesn’t happen. 


You don’t get an exception, but the HashSet’s add() 
method returns a boolean to tell you (if you care) whether 
the new object was added. So if the add() method 

returns false, you know the new object was a duplicate of 
something already in the set. 


Object you're trying to 
. ae to the Hhasheet. 


Object already IN 
the HashSet. 
ee 


Your hash codes 
are the same, but are 
you REALLY equal? 


Object you're trying to add 

runs its equals() method, 

title: Circles “A Comparing itself to song2, 
“hashCode: 74218 and returns true. 


Object already IN 
the HashSet. 
ee 
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overriding hashCode() and equals() 


The Song class with overridden 
hashCode() and equals() 


class SongV4 implements Comparable<SongV4> { Ise calling this 
private String title; trashSet (or ariyone eo 
private String artist; pita sends ? another 
me 


private int bpm; 


public boolean equals (Object aSong) { The GREAT 4 overridden equals 
SongV4 other = (SongV4) aSong; and Strings have oe ko do is ask one 
return title.equals (other.getTitle() ) << method: So all eee the other song $ title. 
} title if it's €9v8 
Same d ; 
public int hashCode () { Ne iia String élass has an overridden 


ethod, so fou Can just ret 
pea oncode on the title Notice how pera ted 
4 are using the SAME instance variable (idle), —_ 


return title.hashCode() ; <~ 
} 


public int compareTo(SongV4 s) { 
return title.compareTo(s.getTitle()); 


} 


SongV4 (String title, String artist, int bpm) { 
this.title = title; 
this.artist = artist; 
this.bpm = bpm; 


Now it works! No duplicates when we 
print out the HashSet. But we didn’t 

sft Cees cuted. call sort() again, and when we put 

seal MeN Mr sisiee the ArrayList into the HashSet, the 
HashSet didn’t preserve the sort order. 
public String getArtist() { File Edit Window Help HashingltOut 

return artist; 
; $java Jukebox9 
public int getBpm() { [somersault, cassidy, $10, havana, $10, 


return bpm; 


; cassidy, 50 ways] 


public String toString() { [$10, $10, 50 ways, cassidy, cassidy, havana, 


return title; somersault] 
} 


[havana, $10, 50 ways, cassidy, somersault] 
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Java Object Law for hashCode() 
and equals() 


The API docs for class Object state the 
rules you MUST follow: 


> If two objects are equal, they MUST 
have matching hash codes. 


> If two objects are equal, calling equals() 
on either object MUST return true. In other 
words, if (a.equals(b)) then (b.equals(a)). 


> If two objects have the same hash code 
value, they are NOT required to be equal. 
But if they’re equal, they MUST have the 
same hash code value. 


> So, if you override equals(), you MUST 
override hashCode(). 


> The default behavior of hashCode() 

is to generate a unique integer for each 
object on the heap. So if you don’t override 
hashCode() in a class, no two objects of 
that type can EVER be considered equal. 


> The default behavior of equals() is to 
do an == comparison. In other words, to 
test whether the two references refer toa 
single object on the heap. So if you don’t 
override equals() in a class, no two objects 
can EVER be considered equal since 
references to two different objects will 
always contain a different bit pattern. 


a.equals(b) must also mean that 
a. hashCode() == b.hashCode() 


But a.hashCode/() == b.hashCode() 
does NOT have to mean a.equals(b) 


collections with generics 


there, are_no 


Dumb Questions 


* How come hash codes can be the same 
even if objects aren’t equal? 


A: HashSets use hash codes to store the 
elements in a way that makes it much faster to 
access. If you try to find an object in an ArrayList 
by giving the ArrayList a copy of the object (as 
opposed to an index value), the ArrayList has to 
start searching from the beginning, looking at 
each element in the list to see if it matches. But 

a HashSet can find an object much more quickly, 
because it uses the hash code as a kind of label on 
the “bucket” where it stored the element. So if you 
say, “| want you to find an object in the set that’s 
exactly like this one...) the HashSet gets the hash 
code value from the copy of the Song you give it 
(say, 742), and then the HashSet says, “Oh, | know 
exactly where the object with hash code #742 is 
stored...,"and it goes right to the #742 bucket. 


This isn’t the whole story you get in a computer 
science class, but it’s enough for you to use 
HashSets effectively. In reality, developing a good 
hashing algorithm is the subject of many a PhD 
thesis, and more than we want to cover in this 
book. 


The point is that hash codes can be the same 
without necessarily guaranteeing that the objects 
are equal, because the “hashing algorithm” used 
in the hashCode() method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same hash code bucket in the HashSet, but that’s 
not the end of the world. The HashSet might be 

a little less efficient, because if the HashSet finds 
more than one object in the same hash code 
bucket, it has to use the equals() on all those 
objects to see if there's a perfect match. 
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TreeSets and sorting 


If we want the set to stay sorted, 
weve got TreeSet 


TreeSet is sumilar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works just like 
the sort() method in that if you make a TreeSet without giving it a Comparator, the TreeSet uses each 
object’s compareTo() method for the sort. But you have the option of passing a Comparator to the TreeSet 
constructor, to have the TreeSet use that instead. 


The downside to TreeSet is that if you don’t need sorting, you’re still paying for it with a small performance 
hit. But you’ll probably find that the hit is almost impossible to notice for most apps. 


public class Jukebox10 { 
public static void main(String[] args) { 
new Jukebox10().go(); 
} 


public void go() { 
List<SongV4> songList = MockMoreSongs.getSongsV4 (); 
System.out.printlin(songList) ; 


songList.sort((one, two) -> one.getTitle() .compareTo (two.getTitle())); 
System.out.printlin(songList) ; 


Set<SongV4> songSet = new TreeSet<>(songList) ; 


h 
System.out.printlin(songSet) ; instead of HashSet: The 


; ) t mpare 10 
TreeSet will wse Sent ; sond; ist. 


If we want the TreeSet to sort on something different (i.e., to NOT use SongV4’s 
compareTo() method), we need to pass in a Comparator (or a lambda) to the TreeSet 
constructor. Then we’d use songSet.addAll() to add the songList values into the TreeSet. 


Set<SongV4> songSet = new TreeSet<>((ol, 02) -> ol.getBpm() - o2.getBpm()) ; 

songSet .addAll(songList) ; 

Yer, another lambda for 
sorting, This one sov 

by BPM. Remember, 
fis lambda implemen 
Comparator: 
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What you MUST know about TreeSet... 


TreeSet looks easy, but make sure you really understand what you need to do to 


use it. We thought it was so important that we made it an exercise so you’d have to 
think about it. Do NOT turn the page until you’ve done this. We mean it. 


harpen your pencil 
emer yf 


Look at this code. 
Read it carefully, then 
answer the questions 
below. (Note: there 
are no syntax errors in 
this code.) 


collections with generics 


———— Answers on page 366. 


import java.util.*; 


public class TestTree { 
public static void main(String[] args) { 
new TestTree() .go() ; 


} 


public void go() { 
Book bl = new Book("How Cats Work") ; 
Book b2 = new Book("Remix your Body") ; 
Book b3 = new Book("Finding Emo") ; 


Set<Book> tree = new TreeSet<>() ; 
tree.add(b1) ; 

tree.add(b2) ; 

tree .add(b3) ; 

System.out.println (tree) ; 


} 


class Book { 
private String title; 
public Book(String t) { 
title = t; 
} 


1. What is the result when you compile this code? 


2. If it compiles, what is the result when you run the TestTree class? 


3. If there is a problem (either compile-time or runtime) with this code, how would you fix it? 
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how TreeSets sort 


TreeSet elements MUST be comparable 


TreeSet can’t read the programmer’s mind to figure out how the objects 
should be sorted. You have to tell the TreeSet how. 


To use a TreeSet, one of these things 
must be true: 


>» The elements in the list 
must be of a type that 
implements Comparable 


The Book class on the previous page didn't class Book implements Comparable<Book> { 
implement Comparable, so it wouldn’t work private String title; 

at runtime. Think about it, the poor TreeSet’s public Book(String t) { 

sole purpose in life is to keep your elements title = t; 

sorted, and once again—it had no idea how to } 


sort Book objects! It doesn’t fail at compile-time, 
because the TreeSet add() method doesn't 
take a Comparable type. The TreeSet add() } 
method takes whatever type you used when } 
you created the TreeSet. In other words, if 

you say new TreeSet<Book>(), the add() 

method is essentially add(Book). And there’s 

no requirement that the Book class implement 
Comparable! But it fails at runtime when you 

add the second element to the set. That’s the 

first time the set tries to call one of the object's 
compareTo() methods and...can't. 


public int compareTo(Book other) { 
return title.compareTo (other.title) ; 


OR class BookCompare implements Comparator<Book> { 
public int compare(Book one, Book two) { 
)» You use the TreeSet’s return one.title.compareTo(two.title) ; 


overloaded constructor } You could use 8 lamioda 


: elaving a 
that takes a Comparator _— instead of de 93 
public class TestTreeComparator { yew Comparator Class. 


public void go() { 
Book bl = new Book("How Cats Work"); 
Book b2 = new Book("Remix your Body"); 


TreeSet works a lot like the sort() 
method—you have a choice of using the 


element's compareTo() method, assuming Book b3 = new Book("Finding Emo"); 

the element type implemented the BookCompare bookCompare = new BookCompare(); 
Comparable interface, OR you can use Set<Book> tree = new TreeSet<>(bookCompare) ; 
a custom Comparator that knows how tree.add(b1); 

to sort the elements in the set. To use a tree.add(b2) ; 

custom Comparator, you call the TreeSet tree.add(b3); 


constructor that takes a Comparator. a 
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We've seen Lists and Sets, now we'll use a Map 


Lists and Sets are great, but sometimes a Map 1s the best collection (not Collection with a 
capital “C”—remember that Maps are part of Java collections but they don’t implement the 
Collection interface). 


Imagine you want a collection that acts like a property list, where you give it a name and it 
gives you back the value associated with that name. Keys can be any Java object (or, through 
autoboxing, a primitive), but you'll often see String keys (i.e., property names) or Integer keys 
(representing unique IDs, for example). 


| 
ci Each element in a Map is actually 


TWO objects—a key and a value. 
key > “Balla” You can have duplicate values, but 
NOT duplicate keys. 


Map example 


public class TestMap { 
public static void main(String[] args) { 
Map<String, Integer> scores = new HashMap<>() ; 


Ht (SS 
ashMap needs TWO type parameters—one for the key and one for the value 


scores.put("Kathy", 42); u 
a put() instead of add( 
cores.put("Bert", 343) ; add(), and 
s put ( li Se it Lakes two ar ments Uk of course 
scores.put("Skyler", 420) ; 3 ey, Value 


System.out.printlin(scores) ; 
System. out.println(scores.get ("Bert") ) 


‘The get) method takes a key and returns 


| the value (in this case, an Integer). 
eer When you print a jar, it gives you the key=value 
Pairs, in braces { } instead of Ire oe Cj 
{Skyler=420, Bert=343, Kathy=42} peers pene e 


343 
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factory methods for collections 


Good point! Let me 
just whip up some 
Factory methods. 


I keep seeing the same code 

popping up again and again for 
creating collections. There must be 
something we can do to make this 
easier for people. 


Creating and filling 
collections 


The code for creating, and then filling, a collec- 
tion crops up again and again. You’ve already 
seen code for creating an ArrayList and adding 
elements to it quite a few times. Code like this: 


List<String> songs = new ArrayList<>() ; 
songs .add("somersault") ; 

songs .add ("cassidy") ; 

songs.add("$10") ; 


Whether you’re creating a List, a Set, or a Map, it looks pretty similar. What’s more, 
these types of collections are often ones where we know what the data is right at the 
start, and then we don’t intend to change it at all during the lifetime of the collection. 
If we wanted to really make sure that no-one changed the collection after we’d 


. ‘ or 
created it, we’d have to add an extra step: fag ” vers oe 
0 
ye XY ered é ot 
List<String> songs = new ArrayList<>(); Rewer es <4 yp enange ne 
songs.add("somersault") ; ox Ane \y ‘ else van \ 
songs.add ("cassidy") ; now - ers Te 
songs.add("$10"); ny see anes wey be 
return Collections.unmodifiableList (songs) ; We sont knat van 
es 


we 
. hs brut" 
Cy 


That’s a lot of code! And it’s a lot of code for something common pranaeo” 
that we probably want to do a lot. 


Fortunately for us, Java now has “Convenience Factory Methods of Collections” (they 
were added in Java 9). We can use these methods to create common data structures 
and fill them with data, with just one method call. 
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Convenience Factory Methods for Collections 


Convenience Factory Methods for Collections allow you to easily create a List, Set, or Map that’s been prefilled 
with known data. There are a couple of things to understand about using them: 


@) The resulting collections cannot be changed. You can’t add to them or 
alter the values; in fact, you can’t even do the sorting that we've seen in this 
chapter. 


Q) The resulting collections are not the standard Collections we've seen. 
These are not ArrayList, HashSet, HashMap, etc. You can rely on them to 
behave according to their interface: a List will always preserve the order in 
which the elements were placed; a Set will never have duplicates. But you 
can't rely on them being a specific implementation of List, Set, or Map. 


Convenience Factory Methods are just that—a convenience that will work for most of the cases where you want 
to create a collection prefilled with data. And for those cases where these factory methods don’t suit you, you can 
still use the Collections constructors and add() or put() methods instead. 


» Creating a List: List. of () 
To create the list of Strings from the last page, we don’t need five lines of code; we just need one: 
List<String> strings = List.of("somersault", "cassidy", "$10") ; 
If you want to add Song objects instead of simple Strings, it’s still short and descriptive: 


List<SongV4> songs = List.of (new SongV4("somersault", "zero 7", 147), 
new SongV4 ("cassidy", "grateful dead", 158), 
new Songv4("$10", "hitchhiker", 140)); 


» Creating a Set: Set. of () 
Creating a Set uses very similar syntax: 


Set<Book> books = Set.of(new Book("How Cats Work"), 
new Book("Remix your Body"), 
new Book("Finding Emo") ) ; 


» Creating a Map: Map. of (), Map.ofEntries () 


Maps are different, because they take two objects for each “entry”—a key and a value. If you want to put less 
than 10 entries into your Map, you can use Map.of, passing in key, value, key, value, etc.: 


Map<String, Integer> scores = Map.of("Kathy", 42, 
"Bert", 343, 
"Skyler", 420); 


If you have more than 10 entries, or if you want to be clearer about how your keys are paired up to their values, 
you can use Map.ofEntries instead: 


Map<String, String> stores = Map.ofEntries (Map.entry("Riley", "Supersports"), 
Map.entry("Brooklyn", "Camera World"), 
Map.entry("Jay", "Homecase") ) ; 


To make the line shorter, you can use a static import on Map.entry (we talked about static imports in Chapter 10). 
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Finally, back to generics 


Remember earlier in the chapter we talked about how methods that 
take arguments with generic types can be...weird. And we mean weird 
in the polymorphic sense. If things start to feel strange here, just 
keep going—it takes a few pages to really tell the whole story. The 
examples are going to use a class hierarchy of Animals. 


abstract class Animal { 
void eat() { 
System.out.printlin("animal eating") ; 


} 

} The simpli f . 

clase Dog eitends Animal 4 simplified Animal ¢lass hierarchy 
void bark() { } 


} 
class Cat extends Animal { 
void meow() { } 


} 


Using polymorphic arguments and generics 


Generics can be a little...counterintuitive when it comes to using 
polymorphism with a generic type (the class inside the angle brackets). Let’s 
create a method that takes a List<Animal> and use this to experiment. 


Passing in List<Animal> 


public class TestGenerics1 { mety the List 
public static void main(String[] args) { od we just | factory 
fee} 


List<Animal> animals = List.of(new Dog(), new Cat(), new Dog()); 
takeAnimals (animals) ; P3,, a List<Animal> into 


} our testAnimals method Method that — as 
public static void takeAnimals (List<Animal> animals) { <— genevit class (Lis 
for (Animal a : animals) { a parameter 
a.eat(); 
seraege we Can eall ONLY th Compiles and runs just fine 
me hods declared in { : é 
: e 
since the animals parar tig wok 


type List<Ani 
Te Tistefnimale. $java TestGenerics1l 


animal eating 


animal eating 
animal eating 
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But will it work with List<Dog>? 


A List<Animal> argument can be passed to a method with a List<Animal> 
parameter. So the big question is, will the List<Animal> parameter accept a 
List<Dog>? Isn’t that what polymorphism is for? 


Passing in List<Dog> 


public void go() { 
List<Animal> animals = List.of(new Dog(), new Cat(), new Dog()); 


takeAni 1 i ALSi)% 
akeAnimals (animals); @_ We know this line worked fine 


Make a Dog List and 


List<Dog> dogs = List.of(new Dog(), new Dog()); 
put a Couple dogs in. 


takeAnimals (dogs) ; <_ Will this work now that we chan 


} rom an array to a List? sed 


public void takeAnimals (List<Animal> animals) { 
for (Animal a: animals) { 
a.eat(); 
} 
} 


When we conppile it: 


File Edit Window Help CatsAreSmarter 


$javac TestGenerics2. java 


TestGenerics2.java:20: error: incompatible types: It looked so right 
) 


List<Dog> cannot be converted to List<Animal> 
takeAnimals (dogs) ; 
Aa 


but went so Wrond... 


1 error 
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And I'm supposed 
to be OK with this? That totally 
screws my animal simulation where the 

veterinary program takes a list of any type 
of animal so that a dog kennel can send a list 
of dogs, and a cat kennel can send a list of 
cats...now you're saying I can't do 
that? 


What could happen if it were allowed...? 


Imagine the compiler let you get away with that. It let you pass a 
List<Dog> to a method declared as: 


public void takeAnimals (List<Animal> animals) { 
for (Animal a: animals) { = 
a.eat(); 
} 
} 


There’s nothing in that method that /ooks harmful, right? After all, the 
whole point of polymorphism is that anything an Animal can do (in this 
case, the eat() method), a Dog can do as well. So what’s the problem with 
having the method call eat() on each of the Dog references? 


There’s nothing wrong with that code. But imagine ¢his code instead: 


public void takeAnimals(List<Animal> animals) { 
animals.add(new Cat()); © Vikes!! We just stuek a Cat in what 
might bea Dogs—only List. 


So that’s the problem. There’s certainly nothing wrong with adding a Cat to 
a List<Animal>, and that’s the whole point of having a List of a supertype 
like Animal—so that you can put all types of animals in a single Animal List. 


} 


But if you passed a Dog List—one meant to hold ONLY Dogs—to this 
method that takes an Animal List, then suddenly you’d end up with a Cat in 
the Dog list. The compiler knows that if it lets you pass a Dog List into the 
method like that, someone could, at runtime, add a Cat to your Dog list. So 
instead, the compiler just won’t let you take the risk. 


If you declare a method to take 
List<Animal>, it can take ONLY a 
List<Animal>, not List<Dog> or List<Cat>. 
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It seems to me there 
should be a way to use polymorphic 
collection types as method arguments 
so that a vet program could take 

Dog lists and Cat lists. Then it would be 
possible to loop through the lists and call 
their immunize() method. It would have 
to be safe so that you couldn't add a 
Cat in to the Dog list. 


We can do this with wildeards 


It looks unusual, but there zs a way to create a method argument that 
can accept a List of any Animal subtype. The simplest way is to use a 
wildcard. 


public void takeAnimals(List<? extends Animal> animals) { 


for (Animal a : animals) { “ » 
eae Remember, the keyword extends here 


means either extends OR implements. 


} 


ff 

So now you’re wondering, “What’s the difference? Don’t you have the 2 

same problem as before?” 

And you’d be right for wondering. The answer is NO. When you use =< — 

the wildcard <?> in your declaration, the compiler won't let you do y 3 

anything that adds to the list! a 
When you use a wildcard in your there, are_neo 4 
method argument, the compiler will pum Questions 
STOP you from doing anything that . . 
could hurt the list referenced by the : Back when we first saw generic methods, there was 
method parameter. a similar-looking method that declared the generic type in 

front of the method name. Does that do the same thing as this 

You can still call methods on the takeAnimals method? 


elements in the list, but you cannot 
add elements to the list. 


A: Well spotted! Back at the start of the chapter, there was a 
In other words, you can do things with method like this: 


the list elements, but you can’t put <T extends Animal> void takeThing(List<T> list) 
new things in the list. 

We actually could use this syntax to achieve a similar thing, but it 
works in a slightly different way. Yes, you can pass List<Animal> 
and List<Dog> into the method, but you get the added benefit 
of being able to use the generic type, T, elsewhere too. 
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Using the method's generic type parameter 


What can we do if we define our method like this instead? 


public <T extends Animal> void takeAnimals(List<T> list) { } 


Well, not much as the method stands right now, we don’t need to use “T” for anything. But if we 
made a change to our method to return a List, for example of all the animals we had success- 
fully vaccinated, we can declare that the List that’s returned has the same generic type as the 
List that’s passed in: 


public <T extends Animal> List<T> takeAnimals(List<T> list) { } 


When you call the method, you know you're going to get the same type back as you put in. 


he 

\ from © 

List<Dog> dogs = List.of(new Dog(), new Dog()); The List we pee as always the 

List<Dog> vaccinatedDogs = takeAnimals (dogs) ; takePvivnd®s he list: we R95 OT 
same 

List<Animal> animals = List.of(new Dog(), new Cat()); 


List<Animal> vaccinatedAnimals = takeAnimals (animals) ; 


If the method used the wildcard for both method parameter and return type, there’s nothing to 
guarantee they’re the same type. In fact, anything calling the method has almost no idea what’s 
going to be in the collection, other than “some sort of animal.” 


public void go() { 
List<Dog> dogs = List.of (new Dog(), new Dog()); 
List<? extends Animal> vaccinatedSomethings = takeAnimals (dogs) ; 


public List<? extends Animal> takeAnimals (List<? extends Animal> animals) { } 


Using the wildcard (“? extends”) is fine when you 
don’t care much about the generic type, you just 
want to allow al] subtypes of some type. 


Using a type parameter (“T”) is more helpful when 
you want to do more with the type itself, for 
example in the method’s return. 
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BE the Compiler, advanced 


Your job is to play compiler and determine which of these statements would compile. 
Some of this code wasn’t covered in the chapter, so you need to work out the answers 
based on what you DID learn, applying the “rules” to these new situations. 


The signatures of the methods used in the exercise are in the boxes. 


private void takeDogs (List<Dog> dogs) { } 
private void takeAnimals(List<Animal> animals) { } | 
private void takeObjects (ArrayList<Object> objects) { | 
Compiles? 


takeAnimals (new ArrayList<Animal>() ) ; 


takeDogs (new ArrayList<Animal>() ) ; 
takeAnimals (new ArrayList<Dog>() ) ; 
takeDogs (new ArrayList<>()) ; 


List<Dog> dogs = new ArrayList<>() ; 
takeDogs (dogs) ; 


takeSomeAnimals (new ArrayList<Dog>()) ; 
takeSomeAnimals (new ArrayList<>()) ; 
takeSomeAnimals (new ArrayList<Animal>() ) ; 


List<Animal> animals = new ArrayList<>() ; 
takeSomeAnimals (animals) ; 


List<Object> objects = new ArrayList<>() ; 
takeObjects (objects) ; 


takeObjects (new ArrayList<Dog>() ) ; 


takeObjects (new ArrayList<Object>() ); 


OO O OOWOW YOUUUOU 


Answers on page 367. 
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Exercise QOLution Fill- in-the-blanks (from page 334) 


Possible Answers: 
Comparator, 
Comparable, 

compareTo( ), 
compare( ), 
yes, 
no 


Given the following compilable statement: 
Collections.sort(myArrayList) ; 
1. What must the class of the objects stored in myArrayList implement? 


2. What method must the class of the objects stored in myArrayList implement? 


3. Can the class of the objects stored in myArrayList implement both 
Comparator AND Comparable? 


Given the following compilable statement: 


Collections.sort(myArrayList, myCompare) ; 


4. Can the class of the objects stored in myArrayList implement Comparable? 


5. Can the class of the objects stored in myArrayList implement Comparator? 


6. Must the class of the objects stored in myArrayList implement Comparable? 


7. Must the class of the objects stored in myArrayList implement Comparator? 


8. What must the class of the myCompare object implement? 


9. What method must the class of the myCompare object implement? 
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yes 


yes 


yes 


no 


no 


Comparator 


compare( ) 
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Solution “Reverse Engineer” Jambdas exercise 
a your pencil (from page 343) 


import java.util.*; 


public class SortMountains { 
public static void main(String[] args) { 
new SortMountains().go(); 


public void go() { 


List<Mountain> mountains = new ArrayList<>(); 
mountains.add(new Mountain("Longs", 14255)); 
mountains.add(new Mountain("Elbert", 14433)); 
mountains.add(new Mountain("Maroon", 14156)); 
mountains.add(new Mountain("Castle", 14265)); 
System.out.println("as entered:\n" + mountains); 


mountains .sort((mount1, mount2) -> mount1.name.compareTo(mount2 .name)) ; 
System.out.println("by name:\n" + mountains); 


mountains.sort((mount1, mount2) -> mount2.height - mount! .height):; 
System.out.println("by height:\n" + mountains); 


| : ies 
, Did ee notice that the height list is 
[ ences: 
class Mountain { Dia Roy oe 
String name; 
int height; 


Mountain(String name, int height) { 
this.name = name; 


this.height = height; earner 
} 
public String toString( ) { %java SortMountains 

return name + "'" + height; as entered: 
} [Longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 


by name: 


[Castle 14265, Elbert 14433, Longs 14255, Maroon 14156] 
by height: 


[Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 
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Solution Sorting with lambdas 
oer your pencil from page 342) 
Sort by BPM astending 
songList.sort((one, two) -> one.getBpm() - two.getBpm() ) ; 
S ; 
ort by title descending 


songList.sort((one, two) -> two.getTitle() .compareTo(one.getTitle())); 
Output: 


File Edit Window Help IntNotString 
Sjava SharpenLambdas 


[50 ways, havana, $10, somersault, cassidy, Cassidy] 


[somersault, havana, cassidy, Cassidy, 50 ways, $10] 


Solution | TreeSet exercise 
eter your pencil (from page 353) 


1. What is the result when you compile this code? 


It compiles correctly 


2. If it compiles, what is the result when you run the TestTree class? 


It throws an exception: 


Exception in thread "main" java.lang.ClassCastException: class Book can- 
not be cast to class java.lang.Comparable 

at java.base/java.util.TreeMap.compare (TreeMap.java:1291) 

at java.base/java.util.TreeMap. put (TreeMap. java: 536) 

at java.base/java.util.TreeSet.add(TreeSet.java:255) 

at TestTree.go(TestTree.java:16) 

at TestTree.main(TestTree.java:7) 


3. If there is a problem (either compile-time or runtime) with this code, how would you fix it? 


Make Book implement Comparable, or pass the TreeSet a Comparator 


See page a 
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BE the Compiler solution 


(from page 363) 


Compiles? 


KR 


takeAnimals (new ArrayList<Animal>() ) ; 
takeDogs (new ArrayList<Animal>() ) ; 
: ‘ : vw 
takeAnimals (new ArrayList<Dog>() ) ; 3 eat here, * a eho 4 
the TYRE 
takeDogs (new ArrayList<>()) ; , a sinatwre- There 


List<Dog> dogs = new ArrayList<>() ; Prerayl's 
takeDogs (dogs) ; 


takeSomeAnimals (new ArrayList<Dog>()) ; 
Here the diamond 
takeSomeAnimals (new ArrayList<>()) ;4— Perator meg 


ns this j 

AvvayList<Animalr 7 
takeSomeAnimals (new ArrayList<Animal>() ) ; 
List<Animal> animals = new ArrayList<>() ; 
takeSomeAnimals (animals) ; 

; doesn k aie ile \ecause 

List<Object> objects = new ArrayList<>() ; Wreebbyetts wan ok 
takeObjects (objects) ; PrerayLists not a 


takeObjects (new ArrayList<Dog>() ) ; 


ce ae See 


takeObjects (new ArrayList<Object>() ); 
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Lambdas and Streams: 
What, Not How 


Did you know, you 
don't have to write absolutely 
everything yourself? You can 

get the APIs to do the work 
for youl! 


What if...you didn’t need to tell the computer HOW to do 
something? Programming involves a lot of telling the computer how to do something: 


while this is true do this thing; for all these items if it looks like this then do this; and so on. 


We've also seen that we don’t have to do everything ourselves. The JDK contains library code, 
like the Collections API we saw in the previous chapter, that we can use instead of writing 
everything from scratch. This library code isn’t just limited to collections to put data into; there 
are methods that will do common tasks for us, so we just need to tell them what we want and 


not how to do it. 


In this chapter we'll look at the Streams API. You'll see how helpful lambda expressions can be 
when you're using streams, and you'll learn how to use the Streams API to query and transform 


the data ina collection. 
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Tell the computer WHAT you want 


Imagine you have a list of colors, and you wanted to print out all the colors. You 
could use a for loop to do this. n 
ae “eonvenienle ast 
This is 9 Loe ereating 3 new td 

method Pp of values: 


a ar ww 
saw this m Chapter \\. 


List<String> allColors = List.of("Red", "Blue", "Yellow") ; 
for (String color : allColors) { 
for loop ( ————— For eath item in the list ereate a 


System. out.println (color) ; temporary variable, color... 


} 
~-then print out each Color. 


But doing something to every item in a list is a really common thing to want to do. 
So instead of creating a for loop every time we want to do something “for each” 
item in the list, we can call the forEach method from the Iterable interface— 
remember, List implements Iterable so it has all the methods from the Iterable 
interface. 


List<String> allColors = List.of("Red", "Blue", "Yellow"); 
allColors.forEach(color -> System.out.printin (color) ) ; 
—— SE 


Create a temporary 
variable named tolor 


For eath item in Print out the color 


the list--- 
The forEach method of a [ist takes a 
lambda expression, which we saw for the 


%java PrintColors first time in the previous chapter. This 

Red 48 a way for you to pass behavior (“follow 

Blue these instructions”) into a method, 

plo instead of passing an object containing 
data (“here is an object for you to use”). 
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a Chats Tonight’s Talk: The for loop and forEach 
& w method battle over the question, “Which is 
) better?” 
ye 
OW 
for loop forEach() 


Tam the default! ‘The for loop 1s so important 

that loads of programming languages have me. 

It’s one of the first things a programmer learns! 

If someone needs to loop a set number of times 

to do something, they’re going to reach for their 

trusty for loop. 
Pff. Please. You are so old, that’s why you’re in all 
the programming languages. But things change, 
languages evolve. There’s a better way. A more 
modern way. Me. 


Sure, fashions change. But sometimes it’s just a 
fad; things fall out of fashion too. A classic like 
me will be easy to read and write forever, even for 


non-Java programmers. 
But look how much work developers need to do to 


write you! They have to control when to start, in- 
crement, and stop the loop, as well as writing the 
code that needs to be run inside the loop. All sorts 
of things could go wrong! If they use me, they just 
have to think about what needs to happen to each 
item, they don’t have to worry about how to loop 
to find each item. 


So much work?! Ha! A developer isn’t scared of a 
little syntax to clearly specify what to do and how 
to do it. At least with me, someone reading my 


code can clearly see what's going on. Dude, they shouldn’t have to see what’s going on. 


It says very clearly in my method name exactly 
what I do—“for each” element I will apply the 
logic they specify. Job done. 


Well I’m faster. Everyone knows that. : 
Well actually, under the covers I’m using a for 


loop myself, but if something is invented later 
that’s even faster, I can use that, and developers 
don’t have to change a single thing to get faster 
code. In fact we’re out of time now so.... 

I said you would disappear soon. 
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When for loops go wrong 


Using forEach instead of a for loop means a bit less typing, and it’s also nice 

to focus on telling the compiler what you want to do and not how to do it. There’s 
another advantage to letting the libraries take care of routine code like this—it can 
mean fewer accidental errors. 


A short Java program is listed below. One block of the program is 
missing. We expect the output of the program should be“1 2345” 
but sometimes it’s difficult to get a for loop just right. 


Mixed Your challenge is to match the candidate block of code (on the left) 

Messages with the output that you'd see if the block were inserted. Not all the 
lines of output will be used, and some of the lines of output might be 
used more than once. 


class MixForLoops { 
public static void main(String [] args) { 
List<Integer> nums = List.of(1, 2, 3, 4, 5); 
String output = ""; 


C. : 
andidate Code 
9°es here 
System.out.printin (output) ; 
} 
} 
Candidates: Possible output: 
fon (ant a) — sil a numskisiizie ()ie ats) 
output += nums.get(i) +" "; i123 4 5 


Compiler error 
for (Integer num : nums) P 


CME OU team Siete 


2 3 GS) 


for {int 1 = 0; i <= nums. length; i++) 


Exception thrown 


Cwigowie a= sonblus ptefsie (ul) ap We 

[ile 2, 3, 4, Si 

for (ant i = 0; i <= nums-siize(); i++) fe ee 
QE oIbIC. F-—= iMNbiNsy teste (aL) ap WY We - i , ; 

[i, 2, 3, 4, Si 

[l, 2, 3, 4, 5 

[1, Bi Shy Al 5) | 


———> Answers on page 417. 
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Small errors in common code can be hard to spot 


The for loops from the previous exercise all look quite similar, and at first glance they all look 
like they would print out all the values in the List in order. Compiler errors can be easiest to 
spot, because your IDE or compiler will tell you the code is wrong, and Exceptions (which 
we'll see in Chapter 13, esky Behavior) can also point to a problem in the code. But it can be 
trickier to spot code that produces incorrect output just by looking at the code. 


Using a method like forEach takes care of the “boilerplate,” the repetitive and common 
code like the for loop. Using forEach, passing in only the thing we want to do, can reduce 
accidental errors in our code. 


If we can ask the API to do 
something “for each element," it 
seems like there are other common 
tasks that we could get the API to do 
for us. 


Yes absolutely, in fact Java 8 
introduced a whole API just for this. 


Java 8 introduced the Streams API, a new set n » 
of methods that can be used on many classes, ao ..) 
including the Collections classes we looked at in 

the previous chapter. 


The Streams API isn’t just a bunch of helpful 
methods, but also a slightly different way of 
working, It lets us build up a whole set of 
requirements, a recipe if you like, of what we 
want to know about our data. 


i» 


Can you think of more examples of the types of 


things we might want to do to a collection? Are 
you going to want to ask similar questions about 
what’s inside different types of collections? Can 
you think of different types of information you 
might want to output from a collection? 
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Building blocks of common operations 


The ways we search our collections, and the types of information we want to output from those 
collections, can be quite similar even on different types of collections containing different types of 


Objects. 


Imagine what you might want do to with a Collection: “give me just the items that meet some crite- 


29 66 


ria,” “change all the items using these steps, 


29 66 


remove all duplicates,” and the example we worked 
through in the previous chapter: “sort the elements in this way.” 


It’s not too hard to go one step further and assume each of these collection operations could be 
given a name that tells us what will happen to our collection. 


sen oa Ba 
WHS BCE: WUAAT? 


We know this is all new, but have a go at matching each operation name 
to the description of what it does. Try not to look at the next page as you 
complete it, as that will give the game away! 


filter Changes the current element in the 
stream into something else 


Sets the maximum number of elements 


ski 
P that can be output from this Stream 
limit While a given criteria is true, will not 
process elements 
distinct Only allows elements that match the 
given criteria to remain in the Stream 
waried Will only process elements while the 
~ given criteria is true 
map States the result of the stream should 
be ordered in some way 
dr op While This is the number of elements at the start 
‘ of the Stream that will not be processed 
takeWhile Use this to make sure duplicates are removed 


———— Answers on page 417. 
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Introducing the Streams API 


The Streams API is a set of operations we can perform on a collection, so when we 
read these operations in our code, we can understand what we’re trying to do with 
the collection data. If you were successful in the “Who Does What?” exercise on the 


previous page (the complete answers are at the end of this chapter), you should have 
seen that the names of the operations describe what they do. 


(These are jpst a few of 
the methods in Ctream.-- 
there are many more: 


java.util.stream.Stream 


> distinct() ; tinct elements 
Stream<T ener consisting of the distin 
Returns 


redicate) 
i ? super 1? , dicate. 
edicate<: ven predi 
Stream<T> ose the elements that match the gi 
Returns 4 strea 


These generi¢s do look 
a little intimidating, 
but don’t panic! We'll 
use the map method 
later, and you'll see it’s 


not as complicated as 
it seems. 


° ize) han max- 
‘ lon maxSi longer t 
stream<T> sees of Seee truncated to be n° 

Returns a stre 

Size in length. 


er) 
2 extends R> mapP 
R map(Function<? super : om eae 
sd . : m with the results of applying the 9 
eturns a streal 
cenenis of this stream. 


Stream<T> skip(long n) 


discarding the first n elements of the stream. 


ing to 
d . rted according 
stream<T? pai . the elements of this stream, S° 
m 
Returns a strea 
natural order. 


{| more 


Relax 


You don’t need to worry too 
much about the generic types 
n the Stream methods; "il 
Streams, and Jambda expressions, | | eee tkwoaciag Seesateas (ast 
were introduced in Java 8. 


see that using Streams “just 
works” the way you’d expect. 


In case you are interested: 


¢ <T> is usually the Type of the object in the stream. 


* <R> is usually the type of the Result of the method. 
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Getting started with Streams 


Before we start going into detail about what the Streams API is, what it does, and how to 
use it, we’re going to give you some very basic tools to start experimenting. 


To use the Streams methods, we need a Stream object (obviously). If we have a collection 
like a List, this doesn’t implement Stream. However, the Collection interface has a 


Assuming we had a List of 
Sings lke this: 


method, stream, which returns a Stream object for the Collection. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 
Stream<String> stream = strings.stream() ; 
[Se 


~we ¢an all this method to get 
a Stream of these Strings. 


Now we can call the methods of the Streams API. For example, we could use limit 
to say we want a maximum of four elements. 


Stream<String> limit = stream.limit (4) ; 
—_—_————— — Sets the maximum number of 


K results to return to 4 


The limit method returns 
another Stream of Strings, 
which we'll assign to another 
variable 


What happens if we try to print out the result of calling limit()? 


System.out.printin("limit = " + limit); 


File Edit_Window Help SliceAndDice 


Sjava LimitWithStream 


limit = java.util.stream.SliceOps$1@7a0ac6e3 


This doesn’t look right at all! What’s a 


SliceOps, and why isn't there a collection 
 —__ of swat the vst four items from the list? 


Like everything in Java, the stream variables in the example are Objects. But a stream 
does no# contain the elements in the collection. It’s more like the set of instructions 
for the operations to perform on the Collection data. 


Stream methods that return another Stream are called 
Intermediate Peetaions These are instructions of things to 
; but they don’t actually perform the operation on their own. 
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What's the point 
of having a method 
called limit if it doesn't 
actually limit my results? 
How am I supposed to see 
the output of the 
method? 


Streams are like recipes: nothing's going to 
happen until someone actually cooks them 


INa “do it 
ra get the cake, 
ov there is 

Dino cake. 


A recipe in a book only tells someone how to cook or bake something. 
Opening the recipe doesn’t automatically present you with a freshly 
baked chocolate cake. You need to gather the ingredients according 


to the recipe and follow the instructions exactly to come up with the 
result you want. 


Collections are not ingredients, and a list limited to four entries is not a 

chocolate cake (sadly). But you do need to call one of the Stream’s “do it” methods 
in order to get the result you want. These “do it” methods are called Terminal 
Operations, and these are the methods that will actually return something to you. 


(These are some 
Lerminal operations on 
Chream.) 


java.util.stream.Stream 


Yes, this looks even 
scarier than the map 
method! Don’t Panic, 
these generi¢ types help 
the compiler, but ou ll 
see when we actually use 
this method, we don't 
have to think about 
these generic types. 


dicate) 
; 2 super T> pre 
tch(Predicate< 
boolean anyMa 


y Pp de d pr te. 
edica ¢ 

Re mm tr if aly element matches the rovl 

turns uc 


i is stream. 
long count) number of elements In this 
Returns 


> collector) 
2 super TAR of this 
ollector<: . lements 
<RA> R ane reduction operation on thee 
Performs 4 
i Collector. 
stream using 4 an 
: irst() f this stream, © 
Optional<T node | describing the first element © 
Returns an Optiona oty. 


|| more 
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Getting a result from a Stream 


Yes, we’ve thrown a lot of new words at you: streams; intermediate operations; terminal operations... 
And we still haven’t told you what streams can do! 


To start to get a feel for what we can do with streams, we going to show code for a simple use 
of the Streams API. After that, we’ll step back and learn more about what we’re seeing here. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Stream<String> stream = strings.stream() ; 

Stream<String> limit = stream.limit(4) ; 

long result = limit.count() ; Call the count terminal 

System.out.printlin("result = " + result); operator, and store the output 
in a variable called result 


Sjava LimitWithStream 


result = 4 


This works, but it’s not very useful. One of the most common things to do with Streams 

is put the results into another type of collection. The API documentation for this method 

might seem intimidating with all the generic types, but the simplest case 1s straightforward: iether 
ole 


erurns 


The stream contained Strings, Terminal operation tha 4 This er nod a the cesults 


so the output object will also will collect the output into bat will ov at 3 List- 


contain Strings. some sort of Object. fe stream 
List<String> result = limit.collect(Collectors.toList() ) ; 
»~ A ; +hods to 
The toList Collects helpful class that contains mevnor 
will output the resol 4 Perommon Coaltector implementarions 
as g List. esults return 
System.out.println("result = " + result); 


Relax We’ll see collect() and the 


Collectors in more detail 


later. 


Sjava LimitWithStream 


For now, collect (Collectors. 
toList) is a magic incantation 


result = [I, am, a, list] to get the output of the stream 


pipeline in a List. 


Finally, we have a result that looks like something we would have expected: we had a 
List of Strings, and we asked to limit that list to the first four items and then collect 
those four items into a new List. 
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Stream operations are building blocks 


We wrote a lot of code just to output the first four elements in the list. We also 
introduced a lot of new terminology: streams, intermediate operations, and terminal 
operations. Let’s put all this together: you create a stream pipeline from three 
different types of building blocks. 


@) Get the Stream from a source collection. 


. stream () 


collection =~ 


Call zero or more intermediate operations on the 
Stream. 


@ Output the results with a terminal operation. 


.collect () = 7 output 


You need at least the first and last pieces of the puzzle to use the Streams API. 
However, you don’t need to assign each step to its own variable (which we were doing on 
the last page). In fact, the operations are designed to be chained, so you can call one 
stage straight after the previous one, without putting each stage in its own variable. 


On the last page, all the building blocks for the stream were highlighted (stream, limit, 
count, collect). We can take these building blocks and rewrite the limit-and-collect 
operation in this way: 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Get the stream for the tollection 
List<String> result = strings.stream() Gils bak bo ahs oe of 
damit (4) < vesults from the stream 


Formatted to align each operation .collect (Collectors .toList()) ; 
directly underneath the one above, ea ae eee 
to clearly show each stage. So Weeks of the 


System.out.println("result = " + result) ; 
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Building blocks can be stacked and combined 


Every intermediate operation acts on a Stream and returns a Stream. That means you 
can stack together as many of these operations as you want, before calling a terminal 
operation to output the results. 


“Lal The source, the intermediate 
rd operation(s), and the terminal 


ri] operation al] combine to form a 
Stream Pipeline. This pipeline 
Tepresents a query on the 
ao origina] collection. 


This is where the Streams API becomes really useful. In the earlier example, we 
needed three building blocks (stream, limit, collect) to create a shorter version of the 
original List, which may seem like a lot of work for a simple operation. 


But to do something more complicated, we can stack together multiple operations in 
a single stream pipeline. 


For example, we can sort the elements in the stream before we apply the limit: 
List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Oe Cort what's in the stream ass the 
* +4 a 
- sorted () =— original collection), using natur its 
Limit the stream to just order, before limiting, the resu 
__ 


ouil> eleimands. limit (4) 


. collect (Collectors.toList()) ; 


System.out.println("result = " + result) ; 


Sjava ChainedStream 


Natural ordering of Strings will 


lace capitali : 
result = [I, Strings, a, am] = eens oo ahead of 
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Customizing the building blocks 


We can stack together operations to create a more advanced query on our collection. 
We can also customize what the blocks do too. For example, we customized the Limit 
method by passing in the maximum number of items to return (four). 


If we didn’t want to use the natural ordering to sort our Strings, we could define a specific 
way to sort them. It’s possible to set the sort criteria for the sorted method (remember, 
we did something similar in the previous chapter when we sorted Lou’s song list). 


Lambda ex Pp 
Pression that tell 
a seek the s rings in the secarted method 
we talked abock ib Wigeidae a tts hich 
In . » wWhié 
recap lambdas late, in this chor ae We'll 


List<String> result = strings.stream() 


.sorted((sl, s2) -> s1.compareToIgnoreCase(s2) ) 


limit (4) 
: s 

.collect (Collectors.toList()); This method from the String, clas 
compares 

String, in a wa 


File Edit Window Help IgnoreCaps or loweréase- 
sjava ChainedStream 


the String, with another 
y that ignores upper 


result = [a, am, I, list] 


Create complex pipelines block by block 


Each new operation you add to the pipeline changes the output from the pipeline. Each 
operations tell the Streams API what it is you want to do. 


List<String> result = strings.stream() 
-sorted((sl, s2) -> sl.compareTolIgnoreCase(s2) ) 
. Skip (2) 
- limit (4) 
collect (Collectors.toList()); 


Sjava ChainedStream 


The stream skipped he £; 
=a two elements ieeitien ee 


result = [I, list, of, Strings] 
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With these longer stream 
pipelines, I guess you don't want the 
computer to run off and perform each 
operation individually and then come back to 
perform the next one, right? So the reason we 
needed a terminal operation was so the library “does 
it" ONLY when it knows ALL the operations in 
the pipeline? 


Yes, because Streams are lazy 


I That doesn’t mean they’re slow or useless! It means that each intermediate 
i | | operation is just the instruction about what to do; it doesn’t perform the 
eS, instruction itself. Intermediate operations are lazily evaluated. 


The terminal operation is responsible for looking at the whole list of instructions, 
all those intermediate operations in the pipeline, and then running the whole set 
together in one go. Terminal operations are eager; they are run as soon as they’re 


called. 


This means that in theory it’s possible to run the combination of instructions in 
the most efficient way. Instead of having to iterate over the original collection 
for each and every intermediate operation, it may be possible to do all the 
operations while only going through the data once. 


T only start my day 
once I know exactly 
what I'm going to do, and 
exactly how to do it. 
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a a 
Terminal operations do all the work 
Since intermediate operations are /azy, it’s up to the terminal operation to do everything. 


Perform all the intermediate operations as efficiently as possible. Ideally, just going 
through the original data once. 


Work out the result of the operation, which is defined by the terminal operation itself. 
For example, this could be a list of values, a single value, or a boolean (true/false). 


3) Return the result. 


Collecting to a List 


Now that we know more about what’s going on in a terminal operation, let’s take a 
closer look at the “magic incantation” that returns a list of results. 


ne 
bat has stati 
Collectors 's 2 ate de difkerent 
Lhods that POR WV ebor. Look 
au entations oF Mind the 
wapiem class 
List<String> result = strings.stream() at 7 ee to toll ek uf o 
.- sorted () most Comm 
skip (2) vesults- 
Tere.; . limit (4) 
/ ey operation: .collect(Collectors.toList() ) ; 
i, Rertorms all ; er) Se lector, 
. 2 limit, 7 i 1 No ) 
the gleets the results fe oni a Tn this case, tts using 3 
instructions ALordiy the vesu ‘ Coll etor th 
3. a ie r Passed into if 9 to helpful predefined ° ee 
S those results puts the results into a Lt 


We will look at more Collectors, and 
other terminal operations, later in the 
chapter. For now, you know enough to 

get going with Streams. 
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Guidelines for working with streams 


Like any puzzle or game, there are rules for getting the stream building blocks to work 
properly. 


@) You need at least the first and last pieces to eee 
create a stream pipeline. 
Without the stream() piece, you don’t get a Stream at all, and without | 2 
the terminal operation, you're not going to get any results. ‘— 


@) You can’t reuse Streams. 


It might seem useful to store a Stream representing a query, and reuse it in multiple places, either 
because the query itself is useful or because you want to build on it and add to it. But once a terminal 
operation has been called on a stream, you can’t reuse any parts of that stream; you have to create a 
new one. Once a pipeline has executed, that stream is closed and can’t be used in another pipeline, 


even if you stored part of it in a variable for reusing elsewhere. If you try to reuse a stream in any way, 
you'll get an Exception. 


Stream<String> limit = strings.stream() 

. Limit (4) ; 
List<String> result = limit.collect(Collectors.toList() ) ; 
List<String> result2 = limit.collect(Collectors.toList()); 


File Edit_Window Help ClosingTime 


Sjava LimitWithStream 


Exception in thread "main" java.lang.IllegalStateException: stream has 


already been operated upon or closed 
at java.base/java.util.stream.AbstractPipeline. 
evaluate (AbstractPipeline.java:229) 


You can’t change the underlying collection 
while the stream is operating. 

If you do this, you'll see strange results, or exceptions. ‘Think 
about it—if someone asked you a question about what was 
in a shopping list and then someone else was scribbling on 
that shopping list at the same time, you’d give confusing 
answers too. 


I'm so confused! 
I'm just trying to 
read this list, but 
it keeps changing! 
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So if you shouldn't 
change the underlying 
collection while you're 

querying it, the stream 
operations don't change the 
collection either, right? 


» Correct! Stream operations don't change the original collection. 


y * 

e The Streams API is a way to query a collection, but it doesn’t make changes to the 
collection itself You can use the Streams API to look through that collection and return 
results based on the contents of the collection, but your original collection will remain 


the same as it was. 


This is actually very helpful. It means you can query collections and output the results 
from anywhere in your program and know that the data in your original collection is 
safe; it will not be changed (“mutated”) by any of these queries. 


You can see this in action by printing out the contents of the original collection after 
using the Streams API to query it. 


List<String> strings = List.of("I", "am", "a", "list", "of", "Strings") ; 


Stream<String> limit = strings.stream() 


. Limit (4) 

.collect (Collectors.toList()); 
System.out.printlin("strings = " + strings) ; 
System.out.printlin("result = " + result) ; 


Sjava LimitWithStream 


No changes to original 
collection after the stream 


strings = [I, am, a, list, of, Strings] | 
operations are run. 


result = [I, am, a, list] 


Only the output ol ject has the 
results of the query. This is a 
brand new List. 
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Rec Code Magnets 


255 J A Java program is all scrambled up on the fridge. 
—— Can you reconstruct the code snippets to make a 

working Java program that produces the output 
listed below? 


.distinct () | 


. sorted () 


System. out .println (coffeesEndingIn0O) ; 


public class CoffeeOrder { 
public static void main(String[] args) { 


List<String> coffees = List.of("Cappuccino", 
"Americano", "Espresso","Cortado", "Mocha", 
"Cappuccino", "Flat White", "Latte") ; 


import java util .*; 


List<String> coffeesEndingInO = coffees .stream() 


impo . 
mport java. util.stream + 
File Edit_Window Help Cafelito . , 


sjava CoffeeOrder 


[Americano, Cappuccino, Cortado, Espresso] 


————> Answers on page 418. 
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Dumb Questions 


Q: Is there a limit to the number of intermediate operations | can put 
in a stream pipeline? 


A: No, you can keep chaining these operations as much as you like. But 
do remember that it's not just computers that have to read and understand 
this code; it’s humans too! If the stream pipeline is really long, it might be 
too complicated to understand. That's when you might want to split it up and 
assign sections to variables, so you can give these variables useful names. 


Q: Is there any point in having a stream pipeline without 
intermediate operations? 


A: Yes, you might find that there’s a terminal operation that outputs the 
original collection in some new shape, which is just right for what you need. 
Be aware, however, that some of the terminal operations are similar to 
methods that exist on the collection; you don’t always need to use streams. 
For example, if you're just using count on a Stream, you could probably 
use size instead, if your original collection is a List. Similarly, anything that 
is Iterable (like List) already has a forEach method; you don’t need to use 
stream() .forEach (). 


Q: You said not to change the source collection while the stream 
operation is in progress. How is it possible to change the collection 
from my code, if my code is doing a stream operation? 


A: Great question! It’s possible to write programs that run different bits of 
code at the same time. We'll learn about this in Chapters 17 and 18, which 
cover concurrency. To be safe, it’s usually best (not just for Streams, but in 
general) to create collections that can’t be changed if you know they don’t 
need to be changed. 


Q: How can | output a List that can’t be changed from the collect 
terminal operation? 


A: If you’re using Java 10 or higher, you can use Collectors. 
toUnmodifiableList, instead of using Collectors. toList, 
when you call collect. 


Q: Can | get the results of the stream pipeline in a collection that 
isn’t a List? 


A: Yes! In the previous chapter we learned that there are a few different 
kinds of collections for different purposes. The Collectors class has 
convenience methods for collecting toList, toSet, and toMap, as well 
as (since Java 10) toUnmodifiableList, toUnmodifiableSet, 
and toUnmodifiableMap. 
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lambdas and streams 


You don’t have to write detailed code 
telling the JVM exactly what to do 
and how to do it. You can use library 
methods, including the Streams API, 
to query collections and output the 
results. 


Use forEach on a collection instead 
of creating a for loop. Pass the method 
a lambda expression of the operation 
to perform on each element of the 
collection. 


Create a stream from a collection 
(a source) by calling the stream 
method. 


Configure the query you want to run 
on the collection by calling one or 
more intermediate operations on the 
stream. 


You won't get any results until you 
call a terminal operation. There 

are a number of different terminal 
operations depending upon what you 
want your query to output. 


To output the results into a new List, 
use collect (Collectors. 
toList) as the terminal operation. 


The combination of the source 
collection, intermediate operations, 
and terminal operations is a stream 
pipeline. 


Stream operations do not change 

the original collection; they are a way 
to query the collection and return a 
different Object, which is a result of the 


query. 
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Hello Lambda, my (not so) old friend 


Lambda expressions have cropped up in the streams examples so far, and you can bet 
your bottom dollar (or euro, or currency of your choice) that you’re going to see more 
of them before this chapter is done. 


Having a better understanding of what lambda expressions are will make it easier to 
work with the Streams API, so let’s take a closer look at lambdas. 


Passing behavior around 


If you wrote a forEach method, it might look something like this: 
for (Element element : list) { 


< This is the s 
Pace wh 
bloek of Code to oe 


| every list element would go. 


the block of code that’s going to go into that nice, blank square. 


Then you want someone calling the method to be able to say: 


forEach (do this:| System.out.printl1n( tem ) —; 
You ¢an't just write this code 


here, because it will be run 


: ds to somehow get 
straightaway. Instead, we This Code nee int ity 
: yo hand this block hold of the element. to Print | 


d : mn 
ot ce cue to the forEach but how Can it a NSIDE the 
method so thal method eat all when that code is 


2 
it when it’s ready. forEach methods 


Now, we need to replace the do this with some sort of symbol to represent that this 
code isn’t to be run straightaway, but instead needs to be passed into the method. We 
could use, oh, let’s see... “->” as this symbol . 


Then we need a way to say “look, this code is going to need to work on values from 
elsewhere.” We could put the things the code needs on the left side of the “do this” 
symbol... 


Hey, I know 
forEach(/item -> System.out.println (item) | H you, you're a lambda 
expression! 
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OK, so now I get that 
the lambda I pass in as a 
method argument is somehow used 
in the body of that method. But 

what is the lambda? How can the 
method USE this chunk of code 
I just passed it? 


Lambda expressions are objects, and you run them by calling 
their Single Abstract Method 


Remember, everything in Java 1s an Object (well, except for the primitive types), and 
lambdas are no exception. 


A lambda expression implements a Functional] Interface. 


This means the reference to the lambda expression 1s going to be a Functional Inter- 
face. So, if you want your method to accept a lambda expression, you need to have a 
parameter whose type is a functional interface. That functional interface needs to be 
the right “shape” for your lambda. 


Back to our imaginary forEach example; our parameter needs to implement a 
Functional Interface. We also need to call that lambda expression somehow, passing 
in the list element. 


Remember, Functional Interfaces have a Single Abstract Method (SAM) . It’s this 
method, whatever its name is, that gets called when we want to run the lambda code. 


i i of what the 
is 1 type to give You an idea 
ey latch te Wel iA at specific Functional 


Interfaces throughout this chapter: 


void forEach( SomeFunctionalInterface lambda ) { 
for (Element element : list) { 


7 . ) 
lambda. singleAbstractMethodName (element) ; dewteke is the lambda's 


A arameter, the “tem” in 
hi The lambda expression on 
Is Wo 
whale a hae the last page 
fistract Methog' inl Lambdas aren't magic: 
unctional inter. foes the 


they're just classes 
like everything else. 


youarehere> 389 


lambda shapes 


The shape of lambda expressions 


We've seen two lambda expressions that implement the Comparator interface: the 
example for sorting Lou’s songs in the previous chapter, and the lambda expres- 
sion we passed into the sorted () stream operation on page 381. Look at this last 
example side by side with the Comparator Functional Interface. 


Comparator Interface Lambda expression (implements Comparator) 
public interface Comparator<T> { 
int compare(T o1, T 02); (sl, s2) -> sl.compareToIgnoreCase(s2) 


se 


The compiler sees the lambda body 
(compare Tol noreCase) has an in 
vesult, and that matehes the return 
type of the compare method on the 
Comparator interface. 


Method arguments ) 


You might be wondering where the return keyword is in the lambda expression. ‘The 
short version 1s: you don’t need it. The longer version is, if the lambda expression is 

a single line, and if the functional interface’s method signature requires a returned 
value, the compiler just assumes that your one line of code will generate the value 
that is to be returned. 


The lambda expression can also be written like this, if you want to add all the parts a 
lambda expression can have: 


(String sl, String s2) -> { 
return sl.compareToIgnoreCase(s2) ; 


} 
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Anatomy of a lambda expression 


If you take a closer look at this expanded version of the lambda expression that 
implements Comparator<String>, you'll see it’s not so different from a standard 
Java method. 


If the lambda body is ing; 
Y is inside ¢url 
ie PS put semicolons on ea 
e lines, just like lines in 4 normal Java 


CString sl, String s2) -> rethed 
{ 


return sl.compareToIgnoreCase(s2); 


Serres 
} atoginecsaen 
\ ose K The lambda body, whieh is cher 8 Te 
\od2 ae aw ew} if line ov multiple lines inside ohh tole 
at i OR ve I+ the lambda overrides a the core functionality. This ¢ wT ike 
tan WC \k Yor neon method that returns a value, that would make up the bag tis 
att od cee one o in lambda body is inside ethod if this oar sralniocye a 
; (ag v cur races, " . ment he xunCTio : 
“gnats Nenu “— a i Set et a og ie ambda body is the aes 
Wwe Ty \prale> of the lambda body. If the an the compare) method in Comparator: 


lambda expression is a single 
line, the Compiler can work out 


what needs to be returned. 


The shape of the lambda (its parameters, return type, and what it can reasonably be 
expected to do) is dictated by the Functional Interface it implements. 
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Variety is the spice of life 


Lambda expressions can come in all shapes and sizes, and still conform 
to the same basic rules that we’ve seen. 


A lambda might have more than one line 


A lambda expression is effectively a method, and can have as many 
lines as any other method. Multiline lambda expressions must be in- 
side curly braces. Then, like any other method code, every line must 
end in a semicolon, and if the method is supposed to return something, 
the lambda body must include the word “return” like any normal 
method. 


agement? 


Life would be a if we 


or . 
pda ¢ Y a (strl, str2) -> { Sem" a. all locked the same. 
ore rind tbr int 11 = strl. length ()\_ ew 
Comers be anes a int 12 = str2.length(); & 


return 12 - 11; 


rly b 
sow , . oder | ll tie ah i eg 
gestendmd . FeSsions 


Return keyword 


require : 


Single-line lambdas don’t need ceremony 


If your lambda expression is a single line, it makes it much easier for the compiler to guess 
what’s going on. Therefore, we can leave out a lot of the “boilerplate” syntax. If we shrink 
the lambda expression from the last example into a single line, it looks like this: 


No need for curly braces aaa. © 


(strl, str2) -> ‘Str2.length() - strl.length() 


No semicolons 
No need for “return” 


This is the same Functional Interface (Comparator) and performs the same operation. 
Whether you use multiline lambdas or single-line lambdas is completely up to you. It will 
probably depend upon how complicated the logic in the lambda expression is, and how 
easy you think it is to read—sometimes longer code can be more descriptive. 


Later, we'll see another approach for handling long lambda expressions. 
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A lambda might not return anything 


The Functional Interface’s method might be declared void; 1.e., it doesn’t return anything. In these 


cases, the code inside the lambda 1s simply run, and you don’t need to return any values from the 
lambda body. 


This is the case for lambda expressions in a forEach method. 


? 
\ 
WI Ne wound brackets! We'l 
ts again in a minute: @FunctionalInterface 
see public interface 
str -> { Consumer<T> { 
Multiline String output bc "str =" = str; void accept(T t); 
\aioda System.out.printlin (output) ; } q\ 


No retury, value 


is Vo the 
thod is void on 
Patio |nterxace 


A lambda might have zero, one, or many parameters 


The number of parameters the lambda expression needs is dependent upon the number of parameters 
the Functional Interface’s method takes. The parameter types (e.g., the name “String’’) are not usually 
required, but you can add them if you think it makes it easier to understand the code. You may need 
to add the types if the compiler can’t automatically work out which Functional Interface your lambda 
implements. 


\f a lambda expression doesn t 


d 
eters, You nee? 
take an anne fe show this- @FunctionalInterface 


use empty public interface Runnable { 


() -> System. out. print1n("Hello!") void eum ()7 


K } 
No method parameters ee 


No need for round brackets if it’s a single parameter 

without a type (remember param types are optional) 
ee @FunctionalInterface 

str -> System.out.printin (str) public interface Consumer<T> { 


ae void accept(T t); 
} 
One method parameter ee A 


@FunctionaliInterface 
public interface Comparator<T> { 
int compare(T ol, T 02); 


} 
; Two method parameters OM 


youarehere> 393 


(str1, str2) -> str1.compareToIgnoreCase (str2) 


lambda method parameters 


How can | tell if a method takes a lambda? 


By now you've seen that lambda expressions are implementations of a functional inter- 
face—that is, an Interface with a Single Abstract Method. That means the type of a 
lambda expression is this interface. 


Go ahead and create a lambda expression. Instead of passing this into some method, as 

we have been doing so far, assign it to a variable. You'll see it can be treated just like any 

other Object in Java, because everything in Java is an Object. The variable’s type is the 

Functional Interface. 
Comparator<String> comparator = (sl, s2) -> sl1.compareToIgnoreCase(s2) ; 
Runnable runnable = () -> System.out.println("Hello!") ; 
Consumer<String> consumer = str -> System.out.printin(str) ; 

How does this help us see if a method takes a lambda expression? Well, the method’s 


parameter type will be a Functional Interface. Take a look at some examples from the 
Streams API: 


Stream<T> filter(Predicate<? super T> predicate) 
boolean allMatch(Predicate<? super T> predicate) 


XQ 


<R> Stream<R> map(Function<? super T,? extends R> mapper) 


nterface 


face predicate<t7 


gFunctionaltl 
public inter 


¢Functional interface 
Public interface Function<t R> 


void forEach(Consumer<? super T> action) 
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Exercise BE the Compiler, advanced —__ 
public interface Runnable { 


Your job is to play compiler and determine void run(); 
. which of these statements would compile. } 
.. But some of this code wasn’t covered in [ESE a 

_ the chapter, so you need to work out the aa Sci aa ae 

| answers based on what you DID | } 
learn, applying the “rules” to 


these new situations. public interface Supplier<T> { 
T get(); 


The signatures of the } 
! functional interfaces are on the 
right, for your convenience. 


public interface Function<T, R> { 
R apply(T t); 


} 


Check the box if the statement would compile. 


L) Runnable r = () -> System.out.println("Hi!") ; 

a Consumer<String> c = s -> System.out.println(s) ; 

L) Supplier<String> s = () -> System.out.println ("Some string") ; 
L) Consumer<String> c = (sl, s2) -> System.out.println(sl + s2); 
a Runnable r = (String str) -> System.out.println(str) ; 


a Function<String, Integer> f = s -> s.length(); 


L) Supplier<String> s () -> "Some string"; 


L) Consumer<String> c s -> "String" + s; 
L) Function<String, Integer> f = (int i) -> "i =" + i; 
L Supplier<String> s = s -> "Some string: " + s; 


LI Function<String, Integer> f = (String s) -> s.length(); 


———> Answers on page 418. 
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Spotting Functional Interfaces 


So far we’ve seen Functional Interfaces that are marked with a @FunctionalInterface annotation 
(we'll cover annotations in Appendix B), which conveniently tells us this interface has a Single Abstract 
Method and can be implemented with a lambda expression. 


Not all functional interfaces are tagged this way, particularly in older code, so it’s useful to understand 
how to spot a functional interface for yourself. 


How hard can it be? I just 
have to look for interfaces 
with only one method! 


Not so fast! 


Originally, the only kind of methods allowed in interfaces were abstract methods, methods 
that need to be overridden by any class that wmplements this interface. But as of Java 8, interfaces 
can also contain default and static methods. 


You saw static methods in Chapter 10, Numbers Matter, and you'll see them later in this chapter 
too. These are methods that don’t need to belong to an instance, and are often used as helper 
methods. 


Default methods are slightly different. Remember abstract classes from Chapter 8, Serious Poly- 
morphism? ‘They had abstract methods that need to be overridden, and standard methods with 
a body. On an interface, a default method works a bit like a standard method in an abstract 
class—they have a body, and will be inherited by subclasses. 


Both default and static methods have a method body, with defined behavior. With interfaces, 
any method that is not defined as default or static is an abstract method that must be 
overridden. 
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Functional interfaces in the wild 


Now that we know interfaces can have non-abstract methods, we can see there’s a bit more of a trick to 


identifying interfaces with just one abstract method. Take a look at our old friend, Comparator. It has a 
lot of methods! And yet it’s still a SAM-type; it has only one Single Abstract Method. It’s a Functional 
Interface we can implement as a lambda expression. 


Object class. 


ActionListener 
Modifier and Type 


void 


Method 


actionPerformed(ActionEvent e) 


Modifier and Type Method 
int compare(T 01, T 02) 

we static <T,U extends Comparable<? comparing(Function<? super T,? extends U> keyExtractor) 
Super U>> 


Comparator<T> 


static <T,U> 
‘omparator<T> 


comparing(Function<? super T,? extends U> keyExtractor, Compa 
super U> keyComparator) 


static <T> Comparator<T> comparingDouble(ToDoubleFunction<? super T> keyExtractor) 
—— 


static <T> Comparator<T> 
— 


comparingInt(ToIntFunction<? super T> keyExtractor) 


static <T> Comparator<T> comparingLong(ToLongFunction<? super T> keyExtractor) 
— 


> boolean equals(Object obj) 


static <T extends Comparable<? 
—— 

super T>> 

Comparator<T> 


naturalorder() 
static <T> Comparator<T> nullsFirst(Comparator<? super T> comparator) 
—— 

static <T> Comparator<T> 
— 


nullsLast(Comparator<? super T> comparator) 


default Comparator<T> reversed() 
— 


Which of these interfaces has a Single Abstract Method and can 
therefore be implemented as a lambda expression? 


BiPredicate 
Modifier and Type Method 


default BiPredicate<T,U> and(BiPredicate<? super T,? super U> other) 


default BiPredicate<T,U> negate() 
default BiPredicate<T,U> or(BiPredicate<? super T,? super U> other) 


boolean test(T t, U u) 


Iterator 
Modifier and Type Method 


default void 
boolean 
E 


default void 
Function 


Modifier and Type Method 


default <V> Function<T,V> andThen(Function<? super R,? extends V> after) 
R apply(T t) 
default <V> Function<V,R> 


static <T> Function<T,T> identity() 


compose(Function<? super V,? extends T> before) 


forEachRemaining(Consumer<? super E> action) 
hasNext() 
next() 


remove() 


SocketOption 
Modifier and Type |= Method 
String name () 


Class<T> type() 


———> Answers on page 419. 
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Lou's back! 


Lou’s been running his new jukebox management software from the 


Now that I have data about 
what's been played on my 
jukebox, I want to know more! 


last chapter for some time now, and he wants to learn so much more 
about the songs played on the diner’s jukebox. Now that he has the 
data, he wants to slice-and-dice it and put it together in a new shape, 
just as he does with the ingredients of his famous Special Omelette! 


He’s thinking there are all kinds of information he could learn about f , 
the songs that are played, like: 


¢ What are the top five most-played songs? 
¢ What sort of genres are played? 
¢ Are there any songs with the same name by different artists? 


We could find these things out writing a for loop to look at our song 
data, performing checks using if statements, and perhaps putting 
songs, titles, or artists into different collections to find the answers to 
these questions. 


But now that we know about the Streams API, 
we know there’s an easier way... 


The code on the next page is your mock code; calling Songs .getSongs () will give you a List of Song 
objects that you can assume looks just like the real data from Lou’s jukebox. 


Type in the Ready-Bake Code on the next 
page, including filling out the rest of the 
Song class. When you've done that, create 
a main method that prints out all the songs. 


What do you expect the output to look like? 
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Here’s an updated “mock” method. It will return some test data that 
we can use on to try out some of the reports Lou wants to create for 
the jukebox system. There’s also an updated Song class. 


public List<Song> getSongs() { 


return List.of ( 
new Song("$10", "Hitchhiker", "Electronic", 2016, 183), 
new Song("Havana", "Camila Cabello", "R&B", 2017, 324), 
new Song("Cassidy", "Grateful Dead", "Rock", 1972, 123), 
new Song("50 ways", "Paul Simon", "Soft Rock", 1975, 199), 
new Song("Hurt", "Nine Inch Nails", "Industrial Rock", 1995, 257), 


new Song("Silence", "Delerium", "Electronic", 1999, 134), 
new Song("Hurt", "Johnny Cash", "Soft Rock", 2002, 392), 


new Song("Watercolour", "Pendulum", "Electronic", 2010, 155), 

new Song("The Outsider", "A Perfect Circle", "Alternative Rock", 2004, 312), 

new Song("With a Little Help from My Friends", "The Beatles", "Rock", 1967, 168), 
new Song("Come Together", "The Beatles", "Blues rock", 1968, 173), 


new Song("Come Together", "Ike & Tina Turner", "Rock", 1970, 165), 
new Song("With a Little Help from My Friends", "Joe Cocker", "Rock", 1968, 46), 
new Song("Immigrant Song", "Karen 0", "Industrial Rock", 2011, 12), 


new Song("Breathe", "The Prodigy", "Electronic", 1996, 337), 
new Song("What's Going On", "Gaye", "R&B", 1971, 420), 


new Song("Hallucinate", "Dua Lipa", "Pop", 2020, 75), 
new Song("Walk Me Home", "P!nk", "Pop", 2019, 459), 


new Song("I am not a woman, I'm a god", "Halsey", "Alternative Rock", 2021, 384), 
new Song("Pasos de cero", "Pablo Alboran", "Latin", 2014, 117), 
new Song("Smooth", "Santana", "Latin", 1999, 244), 


new Song("Immigrant song", "Led Zeppelin", "Rock", 1970, 484)); 


} 


public class Song { 


private final 
private final 
private final 
private final 


private final 


String title; 
String artist; 
String genre; 
int year; 


int timesPlayed,; 


// Practice for you! Create a constructor, all the getters and a toString () 
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Lou’s Challenge #1: Find all the “rock” songs 


The data in the updated song list contains the genre of the song. Lou’s noticed that the 


diner’s clientele seem to prefer variations on rock music, and he wants to see a list of all 
the songs that fall under some genre of “rock.” 


This is the Streams chapter, so clearly the solution is going to involve the Streams API. 
Remember, there are three types of pieces we can put together to form a solution. 


) ‘onal! 
tollection —> . stream () This one’s not veally optional! 
We », 
AP ag look 
that ee if th 2 Streg 


A ist dou 
, = 7 output 
Ou sdid he Nai, 
al 
je mateh what of all the Range 
colleck the sagt incom 


Fortunately, there are hints about how to create a Streams API call based on the require- 


ments Lou gave us: he wants to filter for just the Songs with a particular genre, and he 
wants to collect them into a new List. 


java.util.stream.Streal 


<? super T> predicate) 


er(Predicate sasaivell 
Stream<T? sca £ the elements that match g 7 . 
Returns a stream © Remember tha iL, is th 
v . . use e 
edicate. we're just goin 
pr T,A,R> collector) aan int ation” L, ealleet 
tor<? super ty his 
<R,A>R collect(Collec on on the elements of thi into a List. 
V 


stream using a Collector. 
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Filter a stream to keep certain elements 


Let’s see how a filter operation might work on the list of songs. 


These squares pelea the 

la 
re ‘i rah di ‘Clevent "até 
pee a  Seecent genre: 


fe 
= . stream () 
It’s Possible = Fc) aN K. Tu 
Lypes of Qet a stream from different OOS once 
t i fe ream 


tode, this would be 
oerater Sener pmb expression 
The on Ee Se a =m hat says which tyPes 
pass vege sur 
kare 


Output the results as a List. — seoLLeer Penis) 7 Fc} 
is 
stregetPut of hi 
Py dj PiPeling is s 


ToS thay Just 
He eat 
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Let’s Rock! 


So adding a filter operation filters out elements that we don’t want, and the stream 
continues with just the elements that meet our criteria. It should come as no surprise to find 
that you can use a lambda expression to state which elements we want to keep in the stream. 


The filter method takes a Predicate. 


@Functionalinterface 

so Predicate<T> { 
\poolea” } a 

Returns a aa ee a 


Has a 5 
Given what we know about the shapes of * 4 single Parametey 
lambda expressions, we should be able to 
work out how to write a lambda expression 
that implements Predicate. \ 
a single 
Takes le Must vesult. ip a bool 
param true/false) o'ean value 
Predicat dicate = -> 
redicate predicate | 


We'll know what the type of the single parameter is when we plug it into the Stream opera- 
tion, since the input type to the lambda will be determined by the types in the stream. 


public class JukeboxStreams { 
public static void main(String[] args) { 


List<Song> songs = new Songs().getSongs(); a petavse Get the enre (3 Cie 
This is a List af ¢ This “5 = at 0) on 3 song and see a4 it’s Rey From te 
i Ce ok Songe mm return a true or De i 


List<Song> rockSongs = songs.stream() 


: .filter (song -> song.getGenre () .equals ("Rock") ) 
ipeline Ong > BGRORGR SSS Rae RSguaue SecEE) 


The sbream F ; collect (Collectors. toList()); be 
will vetaen 3 ee at ae This lambda implemen 


one Packs the vesults inbo List Predicate 


System.out.printlin(rockSongs) ; 


File Edit_ Window Help StonefaceVimes 


class Songs { $java JukeboxStreams 
// as Ready-Bake Code 
} [Cassidy, Grateful Dead, Rock 
class Song { With a Little Help from My Friends, The Beatles, Rock, 
// as Ready-Bake Code Come Together, Ike & Tina Turner, Rock, 
} With a Little Help from My Friends, Joe Cocker, Rock, 


Immigrant song, Led Zeppelin, Rock] 
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Getting clever with filters 


The filter method, with its “simple” true or false return value, can contain 
sophisticated logic to filter elements in, or out, of the stream. Let’s take our filter one 
step further and actually do what Lou asked: 


He wants to see a list of all the songs that fall under some genre of “rock.” 
He doesn’t want to see just the songs that are classed as “Rock,” but any genre that 


is kinda Rock-like. We should search for any genre that has the word “Rock” in it 
somewhere. 


There’s a method in String that can help us with this, it’s called contains. 


Returns true if the genre 
has the word “Rock in it 


e 
List<Song> rockSongs = songs.stream() anywher 


.filter (song -> song.getGenre() .contains ("Rock") ) 
—_—__=__ 
.collect (Collectors.toList()) ; 


Sjava JukeboxStreams 


[Cassidy, Grateful Dead, Rock ekurns different 
50 ways, Paul Simon, Soft Rock Now the aun ‘. 

Hurt, Nine Inch Nails, Industrial Rock types one 

Hurt, Johnny Cash, Soft Rock 


Output chop 


in the bo Ped down to Save space 


ok—save the trees/ 


=>) 
Brain Barbell 


Can you write a filter operation that can select 
songs: 


* By The Beatles 
¢ That start with “H” 


¢ More recent than 1995 
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Lou’s Challenge #2: List all the genres 


Lou now senses that the genres of music that the diners are listening to are more 
complicated than he thought. He wants a list of all the genres of the songs that have 
been played. 


So far, all of our streams have returned the same types that they started with. The 
earlier examples were Streams of Strings, and returned Lists of Strings. Lou’s previous 
challenge started with a List of Songs and ended up with a (smaller) List of Songs. 


Lou now wants a list of genres, which means we need to somehow turn the song 
elements in the stream into genre (String) elements. This is what map is for. The map 
operation states how to map rom one type fo another type. 


. stream () 


ani At 
the eS 


mn ts 
slat Ae list of songs \ (7 
ebomne® a stream o sonds- 


(7 
hing i ' You need to give the m 
the Le oo. -map ( C\ ->O ) operation a rare one 
are of one type into iis peices of how to 
nother. Here, we will want ® onvert trom one type to 


to turn songs into genres. another. 


After the maf operation oa’ @ @ The output of this 


-\\ contain tea List 
the stream, + tyre @ am yipeline '§ 3 
elemen of a ditterers are ie genres: 
Lh e Lyre we maPye 


.collect (toList) 


OD @DO®@ 


404 chapter 12 


lambdas and streams 


Mapping from one type to another 


The map method takes a Function. The generics by definition are a bit vague, which 
makes it a little tricky to understand, but Functions do one thing: they take something of 
one type and return something of a different type. Exactly what’s needed for mapping 


varies from one type to another. 


@Func tional Interface 


Public interfa 
ce Function< 
R apply (T t); T, R> { 


sett 
Returns come Ove 


Takes g Single Parametey 


Let’s see what it looks like when we use map in a stream pipeline. 


List of This j . eke 

\t will be a 3 SQ List of ~~ ole param “6 

he vesu’ eis Ay ; sin} Ani 
ping nds) \ecause env Ong objects, Sond, saat an ai 


Sbring; S. 
List<String> genres = songs.stream() ox Sond 
-map(song -> song.getGenre () ) 


.collect (toList()) ; Th 
; € lamb 
Puts the results into a List Veet gy Can return an 
get lenre on yh Pe. By Calling 
stream afte i Song, th 


ane : f 
a stream of laerre) pie ‘a 


The map’s lambda expression is similar to the one for filter; it takes a song and turns it 
into something else. Instead of returning a boolean, it returns some other object, in this 


case a String containing the song’s genre. 


File _Edit_Window Help RoadToNowhere 


Sjava JukeboxStreams 


[Electronic, R&B, Rock, Soft Rock, Industri- 
al Rock, Electronic, Soft Rock, Electronic, 


Alternative Rock, Rock, Blues rock, Rock, 
Rock, Industrial Rock, Electronic, R&B, Pop, 
Pop, Alternative Rock, Latin, Latin, Rock] 
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Removing duplicates 


We've got a list of all the genres in our test data, but Lou probably doesn’t want to wade 
through all these duplicate genres. ‘The map operation on its own will result in an out- 
put List that’s the same size as the input List. Since stream operations are designed to be 
stacked together, perhaps there’s another operation we can use to get just one of every 
element in the stream? 


@® 
— @ - 
astinet operation al This intermediate ati 
Te gry duplicate elements .distinct () doesn't take any ci : te it’s 
getting through just 8 command on ifs oun 


Only One £ 
make it through (oeiect wil 


of the Pipeline. the end @ The output of this stream 


@ ipeline is nt Last 
i 


: S. 
e unique genve 


O@D @ 


.collect (toList) 
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Only one of every genre 


All we need to do is to add a distinct operation to the stream pipeline, and we'll get 
just one of each genre. 


List<String> genres = songs.stream() 
-map(song -> song.getGenre () ) 
ai .distinct () 


; is in the stream 
Having, this in 1 .collect (Collectors.toList()) ; 


pipeline means there will be no 


duplicates a 


LLer this point 
Sjava JukeboxStreams 


Outputs a much more [Electronic, R&B, Rock, Soft Rock, 
readable list of all the genres [A IeTSeHea Rock, Alternative Rock, 
Blues rock, Pop, Latin] 


Just keep building! 


A stream pipeline can have any number of intermediate operations. The power 

of the Streams API is that we can build up complex queries with understandable 
building blocks. The library will take care of running this in a way that 1s as efficient 
as possible. For example, we could create a query that returns a list of all the artists 
that have covered a specific song, excluding the original artists, by using a map 
operation and multiple filters. 


String songTitle = "With a Little Help from My Friends"; 

List<String> result = allSongs.stream() 
.filter (song -> song.getTitle() .equals (songTitle) ) 
-map(song -> song.getArtist() ) 
.filter(artist -> !artist.equals ("The Beatles") ) 
.collect (Collectors.toList()); 


@qaharpen your pencil 
aN 
Try annotating this code yourself. 
What do each of the filters do? 
What does the map do? 


—-» Yours to solve. 
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Sometimes you dont even need a lambda expression 


Some lambda expressions do something simple and predictable, given 
the type of the parameter or the shape of the functional interface. Method references 
Look again at the lambda expression for the map operation. ean replace lambda 


Function<Song, String> getGenre = song -> song.getGenre() ; expressions, but you 
? 
Instead of spelling this whole thing out, you can point the compiler don’t have to use them. 


to a method that does the operation we want, using a method 5 e 
ometimes method 


reference. 
r F nection co output of getGenre() isa references make 
The output of this uw ring, just like the Function d e 
cede bo be 2 Strings needs the code easier to 
understand. 
Function<Song, String> getGenre = Song: :getGenre; This is th a 
= aall in i Ease 
The i sastead £ usin 
we ag to this method vekerente— es vomeiler *, 


w that would cause «2 point the 


a HH 
method, use 3 method. 
ws ka i the divettion of the metno 
om 


Method references can replace lambda expressions in a number of different cases. Generally, we might 
use a method reference if it makes the code easier to read. 


Take our old friend the Comparator, for example. ‘There are a lot of helper methods on the 
Comparator interface that, when combined with a method reference, let you see which value is being 
used for sorting and in which direction. Instead of doing this, to order the songs from oldest to newest: 


List<Song> result = allSongs.stream() 
-sorted((o1l, 02) -> ol.getYear() - o2.getYear() ) 
-collect (toList()); 


Use a method reference combined with a static helper method from Comparator to state what the 
comparison should be: 


List<Song> result = allSongs.stream() 
. sorted (Comparator.comparingInt (Song: :getYear) ) 
-collect (toList()); 


; Relax You don’t need to use method references 
if you don’t feel comfortable with them. 
What’s important 1s to be able to 
recognize the “::” syntax, especially in a 


stream pipeline. 
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Collecting results in different ways 


While Collectors .toList is the most commonly used Collector, there are other useful Collectors. 
For example, instead of using distinct to solve the last challenge, we could collect the results into a 
Set, which does not allow duplicates. The advantage of using this approach is that anything else that uses 
the results knows that because it’s a Set, by definition there will be no duplicates. 


Set<String> genres = songs.stream() 


.map(song -> song.getGenre() ) put the cesults inte ; <4 
r n 
Stove the results in a Set .collect (Collectors.toSet()) ; hich will automatics y only 
lenieaete ante KW have uniave entries. 


eannot Contain duplicates. 


Collectors.toList and 
Collectors.toUnmodifiableList 


You've already seen toList. Alternatively, you can get a List that can’t 
be changed (no elements can be added, replaced or removed) by using 
Collectors. toUnmodifableList instead. ‘This is only available from List 
Java 10 onward. 


Collectors.toSet and 
Collectors.toUnmodifiableSet NO duplicates. 


Use these to put the results into a Set, rather than a List. Remember that a Set Q Doth: (E> 

cannot contain duplicates, and is not usually ordered. If you’re using Java 10 

or higher, you can use Collectors. toUnmodifiableSet if you want to a 
Set 


make sure your results aren’t changed by anything, 


Collectors.toMap and 
Collectors.toUnmodifiableMap 


You can collect your stream into a Map of key/value pairs. You will need to eS) de> (9520 
provide some functions to tell the collector what will be the key and what will a 
Map 


be the value. You can use Collectors. toUnmodifiableMap to create a 
map that can’t be changed, from Java 10 onward. 


Collectors.joining 


You can create a String result from the stream. It will join together all the 
stream elements into a single String. You can optionally define the delimiter, the 
character to use to separate each element. This can be very useful if you want 
to turn your stream into a String of Gomma Separated Values (CSV). 
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But wait, there's more! 


Collecting the results is not the only game in town; collect is just one of many terminal operations. 


Checking if something exists 


You can use terminal operations that return a boolean value to look for certain things in the stream. For 
example, we can see if any R&B songs have been played in the diner. 


boolean result = 
songs .stream() 
.anyMatch(s -> s.getGenre() .equals("R&B")); | boolean allMatch (Predicate p) ; 


boolean anyMatch (Predicate p); 


boolean noneMatch (Predicate p) ; 


Find a specific thing 


Terminal operations that return an Optional value look for certain things in the stream. For example, 
we can find the first song played that was released in 1995. 


Optional<Song> result = Optional<T> findAny () ; 
songs .stream() : . : 
filter(s -> s.getYear() == 1995) Optional<T> findFirst () ; 


-findFirst (); Optional<T> max(Comparator c) ; 


Optional<T> min(Comparator c) ; 


Optional<T> reduce (BinaryOperator a) ; 


Count the items 


There’s a count operation that you can use to find out the number of elements in your stream. We could 
find the number of unique artists, for example. 


long result = 
songs.stream() long count() ; 


.-map (Song: :getArtist) 
.distinct () 


pays There are even more terminal operations, 
and some of them depend upon the type of 
Stream you're working with. 


Remember, the API documentation can 
help you figure out if there’s a built-in 
operation that does what you want. 
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lambdas and streams 


Wait a minute. How cana 
result be “Optional”? What does 
that even mean? 


Well, some operations may return something, or may not return 
anything at all 

It might seem weird that a method may or may not return a value, but it 

happens all the time in real life. 


Imagine you’re at an ice-cream stand, and you ask for strawberry ice 
cream. 


Strawberry ice 


cream, please! 


Here you go! IceCream iceCream = 
getIceCream ("Strawberry") ; 


Easy, right? But what if they don’t have any strawberry? The ice-cream 
person is likely to tell you “we don’t have that flavor.” 


We don't have 


any, sorry. 


It’s then up to you what you do next—perhaps order chocolate instead, 
find another ice-cream place, or maybe just go home and sulk about your 
lack of ice cream. 


Imagine trying to do this in the Java world. In the first example, you get 
an ice-cream instance. In the second, you get...a String message? But a 

message doesn’t fit into an ice-cream-shaped variable. A null? But what 
does null really mean? 
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optional 


Optional is a wrapper 


Since Java 8, the normal way for a method to declare that sometimes it might not return a 
result 1s to return an Optional. This is an object that wraps the result, so you can ask “Did 
I get a result? Or is it empty?” Then you can make a decision about what to do next. 


Strawberry ice 


cream, please! : : 
H | Optional<IceCream> optional = 
0 ere you go! " ny. 
getIceCream("Strawberry") ; 
oa 0 


Do you have if (optional.isPresent()) { 
something 
inside? 
8 
ra) 
Great! Give it to 
me! Please. 
a) IceCream ice = optional.get() ; 
} 
ra) 
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lambdas and streams 


You've just introduced two 
new steps for me to get my 
ice cream! 


Yes, but now we have a way to ask if we have a result 


Optional gives us a way to find out about, and deal with, the times 
when you don’t get an ice cream. 


Optional<IceCream> optional = 
getIceCream("Strawberry") ; 


Strawberry ice 
cream, please! 


0 Here you go! 
o fe) 
o 
Do you have if (optional.isPresent()) { 
something 
inside? 
10) 
va) 
re) 
o 
OK, never mind, 
thanks. } else { 
7) System.out.println("No ice 
» cream for you!"); 


} 


In the past, methods might have thrown Exceptions for this case, or 
return “null”, or a special type of “Not Found” ice-cream instance. Re- 
turning an Optional from a method makes it really clear that anything 
calling the method needs to check if there’s a result first, and then 
make their own decision about what to do if there isn’t one. 
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optional 
Don't forget to talk to the Optional wrapper 


The important thing about Optional results is that they can be empty. If you don’t 
check first to see if there’s a value present and the result is empty, you will get an 
exception. 


Strawberry ice 


Optional<IceCream> optional = 


cream, please! 
getIceCream ("Strawberry") ; 


Here you go! 


IceCream ice = optional.get() ; 


File Edit Window Help Boom 


Sjava OptionalExamples 


Exception in thread "main" java.util.No- 
SuchElementException: No value present 
at java.base/java.util.Optional. 
get (Optional . java:148) 
at chl0c.OptionalExamples. 


main (OptionalExamples.java:11) 
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2 The Unexpected Coffee 
7” Alex was programming her mega-ultra-clever (Java-powered) coffee machine to give her the 
types of coffee that suited her best at different times of day. 


Five-Minute In the afternoons, Alex wanted the machine to give her the weakest coffee it had available (she 
had enough to keep her up at night; she didn’t need caffeine adding to her problems!). As an 


Myster y experienced software developer, she knew the Streams API would give her the best stream of 
coffee at the right time. 


The coffees would automatically be sorted from the weakest to the strongest using 
natural ordering, so she gave the coffee machine these instructions: 


Optional<String> afternoonCoff = coffees.stream() 
-map (Coffee: :getName) 


.-sorted () 


-findFirst(); 


The very next day, she asked for an afternoon coffee. To her horror, the machine presented her 
with an Americano, not the Decaf Cappuccino she was expecting. 


“T can’t drink that!! P’Il be up all night worrying about my latest software project!” 


What happened? Why did the coffee machine give Alex an Americano? 


> Answers on page 419. 
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puzzle: Pool Puzzle 


, 


W W . 

\ Your job is to take code snippets from eee TEE ECR NTS BeeETee") ' 

the pool and place them into the blank 4 
lines in the code. You may not use the } 
same snippet more than once, and } 
you won't need to use all the snip- ec cegeaeieet 
pets. Your goal is to make a class that private final List<Song> songs = 
will compile and run and produce the new JukeboxData. Songs () .getSongs (); 
output listed. 


public class StreamPuzzle { 
public static void main(String[] args) 
SongSearch songSearch = ;: 
Poo] Puzzle songSearch. ; 


di 


void printTopFiveSongs() { 
List<String> topFive = songs.stream() 


Output -collect ( 
System.out.println (topFive) ; 
File Edit Window Help Diveln 


} 


void search(String artist) { 
[Immigrant Song, With a Little = songs.stream() 


Help from My Friends, Hallucinate, 


S$java StreamPuzzle 


Pasos de cero, Cassidy] 


With a Little Help from My Friends ae ; 

System. out.println ( i 
No songs found by: The Beach Boys } else { 

System. out.println ( ); 


Note: each thing from 
the pool can be used 
only once! 


result.get().getTitle() 
printTopFiveSongs() findFirst() 


songSearch.search("The Beach Boys") SongSearch 
"No songs found by: " + artist result.isPresent() 


songSearch \ 
limit(5) sorted(Comparator.comparingInt(Song::getTimesPlayed)) 
new SongSearch() _— Collectors.toList() 


Optional<Song> result 


filter(song -> song.getArtist().equals(artist)) 
= map(song -> song.getTitle()) 


———_—_—_> 
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Mixed Messages 


(from page 372) 
Candidates: Possible output: 
zene (shee ah > Ge ol << igiviniss Sawen()) 7 alas) 
output += nums.get(i) + " "; i 23 4 5 


Compiler error 
for (Integer num : nums) 


output += nums + " "; 


As WS 


for (int 1 = Oy 1 <= nums.length; i++) 


Exception thrown 


outpUuE += nums.get (i) + ™ "; 
: : . . : [ip 2 Sp Ge Sl 
ee a ee ee ce esi 
Pp -g ; ale OO ie She = re S| 
ll, 2, Sp 4, 5 
[ile 2p Sy Be SI 
WHE Dees WHAT? 
al (from page 374) 
filter Changes the current element in the 


stream into something else 


Sets the maximum number of elements 
that can be output from this Stream 


While a given criteria is true, will not 
g 5 
process elements 


distinct Only allows elements that match the 
given criteria to remain in the Stream 
Will only process elements while the 
given criteria 1s true 


sorted 


mal States the result of the stream should 
P be ordered in some way 
dropWhile This is the number of elements at the start 
ai of the Stream that will not be processed 
Use this to make sure duplicates are 
removed 


takeWhile 
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exercise solutions 


Code Magnets (from page 386) 


import java.util.*; 
import java.util.stream.*; 


public class CoffeeOrder { 
public static void main ( 
List<String> coffees 
"Americano", 
"Cappuccino", 


List<String> coffeesEndingInO = coff 


Espresso", 


What would happen if the 
stream operations were in 


a different order? Does it 
matter? 


File Edit_Window Help Cafelito 


String[] args) { %java CoffeeOrder 


List.of ("Cappuccino", 
"Cortado", "Mocha", 
"Flat White", "Latte"); 


[Americano, Cappuccino, 
Cortado, Espresso] 


s.stream() 
-filter(s -> s.endsWith("o") ) 
. sorted () 
.-distinct () 
-collect (Collectors.toList()); 


System.out.printlin(coffeesEndingIn0O) ; 


} 
} 


BE the Compiler (from page 395) 


Runnable r () 


QW Consumer<String> c 


L) Supplier<String> s 


L) Consumer<String> c 


L) Runnable r (String 


Wy Function<String, 


-> System.out.println("Hi!") ; 


Integer> f = s -> s.length(); 


esn 
3 Skrind rout O° 


s -> System.out.println(s) ; gre” 


Chol 
() 


-> System.out.println("Some string") ; 


Should take only one 
(sl, s2) -> System.out.println(sl + s2); parameter but has two 


str) -> System.out.println (str) 7~ Shoulg ,, 4 
1o have Param 
eters 


e-line lambda effectively returns a String 


Kie cine ino. Eve 
<i nt ene s = () -> "Some string"; ie a sa method nee pee : 
} “eturn is Caléu 
dea h there s no return, ; 
L) Consumer<String> c = s -> "String" + s; “ee assumed to be the ee 
5 Should have a String parameter and 
Function<String, Integer> f = (int i) -> "i =" + i; return an int, but in ead it has an 
int Param and returns a String 
L) Supplier<String> s = s -> "Some string: " + s; 


L) Function<String, 
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RH > Should not have any parameters 
Integer> f = 


() 


-> ac > ia ("Some string") ; 
Should take a String parameter. Should return an int, but actually returns nothing, 


lambdas and streams 


, ‘ BiPredicate od 
oer your pencil sroditier and Type Method estat Meta 


from page 397 default BiPredicate<T,U> and(BiPredicate<? super1,? super U> other) Sinohle 
(from page 397) Was 0 The overs a 
default BiPredicate<T,U> negate() kestt . 
s: 
default BiPredicate<T,U> or(BiPredicate<? super T,? super U> sc mer nod 
boolean test(T t, U u) 
ActionListener 
Modifier and Type fethod : + Method 
e bstrae’ 
void = e) ££ Has a Sing} A 
Iterator 
Modifier and Type Method 
Has TWO abstr ¢ default void forEachRemaining(Consumgf/<? super E> action) 
hasNe +0 . methods boolean hasNext 
*UY and nextQ = g 
“= E next() 
default void remove() 
Function 
Modifier and Type Method H. 
default <V> Function<T,V> = andThen(Function<? super R,?/extends V> after) I rhe Abstract Method, 
R apply(T t) ee Pry : The others are default 


; . and stati¢ methods. 
default <V> Function<V,R> compose (Function<? per V,? extends T> before) 


static <T> Function<T,T> identity() f 
SocketOption 
Modifier and Method 


Has two abstract methods String aad 


Class<T> thee() 


Five-Minute Mystery (from page 415) 


Alex didn’t pay attention to the order of the stream operations. She first mapped the 
coffee objects to a stream of Strings, and then ordered that. Strings are naturally ordered 
alphabetically, so when the coffee machine got the “first” of these results for Alex’s 
afternoon coffee, it was brewing a fresh “Americano.” 


If Alex wanted to order the coffees by strength, with the weakest (1 out of 5) first, she 


needed to order the stream of coffees first, before mapping it to a String name, 
afternoonCoff = coffees.stream() 


.sorted () 


-map (Coffee: : getName) 
-findFirst(); 


Then the coffee machine will brew her a decaf instead of an Americano. 
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puzzle solutions lambdas and streams 


Pos] Puzzle (from page 416) 


public class StreamPuzzle { 


public static void main(String[] args) { 
SongSearch songSearch = new SongSearch(); 
songSearch.printTopFiveSongs(); 
songSearch. search ("The Beatles") ; 
songSearch.search("The Beach Boys") ; 


} 
class SongSearch { 
private final List<Song> songs = 
new JukeboxData.Songs () .getSongs (); 


void printTopFiveSongs() { 
List<String> topFive = songs.stream() 
. sorted(Comparator.comparingInt(Song::getTimesPlayed)) 
.map(song -> song.getTitle()) 
. limit(5) 
.collect (Collectors.toList()) ; 
System.out.printlin(topFive) ; 
} 


void search(String artist) { 
Optional<Song> result = songs.stream() 
. filter(song -> song.getArtist().equals(artist)) 
. findFirst() ; 
if (result.isPresent()) { 
System.out.print1n (result.get().getTitle()) ; 
} else { 
System.out.println ("No songs found by:" + artist) ; 
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13 exception handling 


Risky Behavior 


Sure, it's risky, but 
I can handle it if 
something goes wrong. 


Stuff happens. The file isn’t there. The server is down. No matter how 
good a programmer you are, you can’t control everything. Things can go wrong. Very wrong. 
When you write a risky method, you need code to handle the bad things that might happen. 
But how do you know when a method is risky? And where do you put the code to handle the 
exceptional situation? So far in this book, we haven't really taken any risks. We've certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we're talking about 
here is for code that you can’t guarantee will work at runtime. Code that expects the file to be 

in the right directory, the server to be running, or the Thread to stay asleep. And we have to do 
this now. Because in this chapter, we’re going to build something that uses the risky JavaSound 


API. We're going to build a MIDI Music Player. 
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building the MIDI Music Player 


Let’s make a Musie Machine 


Over the next three chapters, we’ll build a few different sound ap- 
plications, including a BeatBox Drum Machine. In fact, before 
the book is done, we'll have a multiplayer version so you can 


send your drum loops to another player, kind of like sharing 
over social media. You’re going to write the whole thing, al- 
though you can choose to use Ready-Bake Code for the GUI 
parts. OK, so not every IT department is looking for a new 
BeatBox server, but we’re doing this to learn more about Java. 
Building a BeatBox is just a way to have fun while we’re learning 
Java. 


The finished BeatBox looks something like this: 


You make a beatbox loop (a |b 


beat drum 
putting check marks in the box rum pattern) by 


es. 


= 
eee Cyber BeatBox 


Bass Drum 
Closed Hi-Hat 

| p 

| Open Hi-Hat 

_ Acoustic Snare 

Crash Cymbal 


Your message 
gets sent to 
the other 

1 players, along 


Tempo Up 


Tempo Down 


Hand Clap sendlt with your 
High Tom eurrent beat 
| Hi Bongo dance beat ee 
| Maracas a“ | ‘ 
| Whistle when 7 hi 
P) 
Low Conga “sendlt. 
Cowbell ; 
River: groove #2 
Vibraslap 
| Low-mid Tom Brooklyn: groove2 revised 
ee Se BoomTish: dance beat 
Open Hi Conga 
: . Inomin 
Notice the check marks in the boxes for each of the 16 “beats.” For example, on is 3 messages fro,, 
beat | (of 16) the Bass drum and the Maracas will play, on beat 2 nothing, and on Players. Cliek one to load 
beat 3 the Maracas and Closed Hi-Hat...you get the idea. When you hit Start, it he Pattery that 
‘ nae 1 vou hi « » it, 9 Jes with 
plays your pattern in a loop until you hit Stop. At any time, you can “capture” one 1 and they, tliek © 
of your own patterns by sending it to the BeatBox server (which means any other play it. tart to 


players can listen to it). You can also load any of the incoming patterns by clicking 
on the message that goes with it. 
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We'll start with the basics 


Obviously we’ve got a few things to learn before the whole program 
is finished, including how to build a GUI, how to connect to another 
machine via networking, and a little I/O so we can send something to 
the other machine. 


Oh yeah, and the JavaSound API. That’s where we'll start in this 
chapter. For now, you can forget the GUI, forget the networking and 
the I/O, and focus only on getting some MIDI-generated sound to 
come out of your computer. And don’t worry if you don’t know 

a thing about MIDI or a thing about reading or making music. 


MIDI file 


Everything you need to learn 1s covered here. You can almost smell 
the record deal. 


hit it 
The JavaSound API 


JavaSound is a collection of classes and interfaces added to Java 
way back in version 1.3. These aren’t special add-ons; they’re part 
of the standard Java SE class library. JavaSound is split into two 

parts: MIDI and Sampled. We use only MIDI in this book. MIDI 

stands for Musical Instrument Digital Interface, and is a standard 
protocol for getting different kinds of electronic sound equipment 
to communicate. But for our BeatBox app, you can think of 
MIDI as a kind of sheet music that you feed into some device 
like a high-tech “player piano.” In other words, MIDI data 
doesn’t actually include any sound, but it does include the 
mstructions that a MIDI-reading instrument can play back. 
Or for another analogy, you can think of a MIDI file like an 
HTML document, and the instrument that renders the MIDI 

file (.e., plays it) is like the web browser. J 


MIDI data says what to do (play middle C, and here’s how hard to hit 
it, and here’s how long to hold it, etc.), but it doesn’t say anything at 
all about the actual sound you hear. MIDI doesn’t know how to make 
a flute, piano, or Jimi Hendrix guitar sound. For the actual sound, we 
need an instrument (a MIDI device) that can read and play a MIDI 
file. But the device is usually more like an entire band or orchestra of 
instruments. And that instrument might be a physical device, like a 
keyboard, or it could even be an instrument built entirely in software, 
living in your computer. 


For our BeatBox, we use only the built-in, software-only instrument 
that you get with Java. It’s called a synthesizer (some folks refer to it as 
a software synth) because it creates sound. Sound that you hear. 


play high CG 


and hold it 


exception handling 


Lormacion 
Cie has * 
goov vt doesn 
Lit 
be layed» \ sound gata 
pave YF sheet mvs 


MIDI device knows how to “read” 
a MIDI file and play back the 
sound. The device might bea 
synthesizer keyboard or some 
other kind of instrument. 
Usually, a MIDI instrument can 
play a LOT of different sounds 
(piano, drums, violin, et¢.), and all 
at the same time. Soa MID] file 
isn’t like sheet musi¢ for just one 
musician in the band—it éan hold 
the parts for ALL the musi¢ians 
playing a particular song, 
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but it looked so simple 


First we need a Sequencer 


Before we can get any sound to play, we need a Sequencer object. The sequencer is the 
object that takes all the MIDI data and sends it to the right instruments. It’s the thing 

that plays the music. A sequencer can do a lot of different things, but in this book, we’re 
using it strictly as a playback device. It’s like a device that streams music, but with a few 
added features. ‘The Sequencer class is in the Javax.sound.midi package. So let’s start by 


making sure we can make (or get) a Sequencer object. 


import javax.sound.midi.*; 


public class MusicTest1 { 


public void play() { 
try { 


Sequencer sequencer = MidiSystem.getSequencer () ; 


biect. It’s 
ed a Sequencer 00) 
ue part of the MIDI device/ 
instrument we're usind, |t’s the 
thing, that, well, sequences all ue 
MIDI information into a Sond 
don’t make a brand new 
wens <—we have to ask the 


one ourselve 


ore ive us one- 
System.out.printin ("Successfully got a sequencer") ; MidiSystem to give 


public static void main(String[] args) { 
MusicTestl mt = new MusicTestl1 () ; 


mt.play() ; 


Something’s wrong! 
This code won’ compile! The Compi 
“unreported exception” that must 


ler says there’s an 
be caught or declared. 


File dt Window Help SayWhat® OT 


% javac MusicTestl.java 


MusicTest1l.java:13: 
MidiUnavailableException; 


thrown 


Sequencer sequencer 


1 errors 
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unreported exception javax.sound.midi. 
must be caught or declared to be 


MidiSystem.getSequencer () ; 


exception handling 


What happens when a method you want to call 
(probably in a class you didn’t write) is risky? 


@ Let’s say you want 
to call a method ina 
class that you didn’t 
write. 


@ That method does 
something risky, 
something that might 
not work at runtime. 


@® You need to know 
that the method 
you’re Calling is 
risky. 


@ You then write code 
that can handle the 
failure if it does 
happen. You need to be 
prepared, just in case. 


Write ok uses Methods 
2 


your code class you 


didn't write 


void moo() { 
if (serverDown) { 
explode () ; 
} 


class you 
didn't write } 


I wonder if 
that method 
could blow up... 


My moo() 
method will 
explode if the 
server is down. 


Now that I 
know, I can take 


precautions. 
class you 


didn't write 


your code 


you are here > 
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when things might go wrong 


Methods in Java use exceptions to tell the calling code, 
“Something Bad Happened. | failed.” 


Java’s exception-handling mechanism is a clean, well-lighted way to handle “exceptional 
situations” that pop up at runtime; it lets you put all your error-handling code in one easy-to- 
read place. It’s based on the method you're calling ¢elling you it’s risky (i.e., that the method might 
generate an exception), so that you can write code to deal with that possibility. If you know you 
might get an exception when you call a particular method, you can be prepared for—possibly even 
recover from—the problem that caused the exception. 


So, how does a method tell you it might throw an exception? You find a throws clause in the 
risky method’s declaration. 


The getSequencer() method takes a risk. It can fail at runtime. 
So it must “declare” the risk you take when you call it. 


The API does tell You 


that getSequenter() 
getSequencer 
¢an throw an exception: 
public static Sequencer getSequencer() id; : ‘ 
throws MidiUnavailableException MidiUnavailableException. 


Obtains the default Sequencer, connected to a default device. The returned Sequencer instance is connected to the A method has to dee lave 
default Synthesizer, as returned by getSynthesizer(). If there is no Synthesizer available, or the default the exceptions it might 
Synthesizer cannot be opened, the sequencer is connected to the default Receiver, as returned by getReceiver(). dh 

The connection is made by retrieving a Transmitter instance from the Sequencer and setting its Receiver. Closing row. 

and re-opening the sequencer will restore the connection to the default device. 


This method is equivalent to calling getSequencer(true). 


If the system property javax.sound.midi.Sequencer is defined or it is defined in the file "sound.properties", it is 
used to identify the default sequencer. For details, refer to the class description. 


Returns: 
the default sequencer, connected to a default Receiver 


Throws: 
MidiUnavailableException - if the sequencer is not available due to resource restrictions, or there is no Receiver 
available by any installed MidiDevice, or no sequencer is installed in the system 


See Also: 
getSequencar(boolean), getSynthesizer(), getReceiver() 


This part tells you WHEN you might get that Risky methods that could fail ad 

exception—in this Case, because of resource . runtime declare the exceptions 

vestrittions (which could mean the sequencer 's that might happ en using “throws 

already being used). SomeK indOfException” on their 
method declaration. 
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exception handling 


TS kno FD ; 
The compiler needs to know , LEN ye Wy 
2 s S A OC: if 
that YOU know youre calling MT doe sar 
a risky method Weed Sechy iy Ypres, 


If you wrap the risky code in something called a try/ ia 


catch, the compiler will relax. Cchy, 


A try/catch block tells the compiler that you know an Lye ; 
exceptional thing could happen in the method you’re ay Shore 


calling, and that you’re prepared to handle it. That WA Cop b/ ise 
compiler doesn’t care how you handle it; it cares only i lhe. the /tif, TF 
that you say you’re taking care of it. / eg 


ela CCh 


VA rea, As ye 


import javax.sound.midi.*; 


Wty py ’ 
(Eee Voblemns befope aff 


OSE, 


public class MusicTestl { 


public void play() { 


try { 
S = Midi . the wisky {hing 
quencer sequencer MidiSystem.getSequencer (); Put : its ne 
System.out.println ("Successfully got a sequencer") a “try block. 
} catch (MidiUnavailableException e) { Sasky” caeaet 
System.out.println ("Bummer") ; ethod that ie 
} tyrow an excepu 
. . . . . r do if the pares OF what 
public static void main(String[] args) { PPens—j, €Ptiong| sit 
7) 
MusicTestl mt = new MusicTest1(); MidiUnay,;) 7 er Words, P ati 
e 
mt.play(); Y the eall i‘ . *Ception is tise 
} Cquencer-() in 
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exceptions are objects 


I'm gonna 
TRY this risky thing, 


and I'm gonna 


CATCH myself if I fall. 


An exception is an object... 
of type Exception 


This is fortunate, because it would be much harder to 
remember if exceptions were of type Broccoli. 


Remember from the polymorphism chapters (7 and 8) 
that an object of type Exception can be an instance of 
any subclass of Exception. 


Because an Exception 1s an object, what you catch is an 
object. In the following code, the catch argument is 
declared as type Exception, and the parameter reference 


Don't try this at home. 


variable is ex. 


Throwable 
getMessage() try { 
F . avin) 
printStackTrace() iif @o-sieky thing Wes yt Vike deel 
4 hod argurer™ 
Part of the Exception il 
: . They 4 
elass hierarchy i 
cathend 355 Throwable erection } catch(Exception e) { 
and anherit two Key // try to recover 
methods } yRK. This Code 
xcept runs only if is 
io) 
nis thy, a 
IOException InterruptedException What you write in a catch block depends on the excep- 


tion that was thrown. For example, if a server is down, 
you might use the catch block to try another server. If the 
file isn’t there, you might ask the user for help finding it. 
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exception handling 


If it’s your code that catches the exception, 
then whose code throws it? as ONS MEXCEDHIog 


You'll spend much more of your Java coding time handling excep- 
tions than you'll spend creating and throwing them yourself. For now, 
just know that when your code calls a risky method—a method that 
declares an exception—it’s the risky method that throws the exception 
back to you, the caller. 


your code class witha 


In reality, it might be you who wrote both classes. It really doesn’t mat- risky method 


ter who writes the code...what matters is knowing which method ¢hrows 
the exception and which method catches it. 


When somebody writes code that could throw an exception, they must 
declare the exception. 


\d (oy 
ig metnod ust te me aexcerton 
@) Risky, exception-throwing code: one khat 1 Lyrows 

public void takeRisk() throws BadException { One method Will 

if (abandonAllHope) { 

throw new BadException () ; eatch what another 

} 

N Ge method throws. An 
= ate 5 hew Ex i oa 
ICE ang gy "Pion exception is always 
ow if 


thrown back te the 


caller. 


The method that 


@ Your code that calls the risky method: 
throws has te declare 
public void crossFingers() { re) ° oO 
a that it might throw 


anObject.takeRisk () ; the exception. 
} catch (BadException e) { 
System. out.println("Aaargh!") ; 


.printStackT 
| e.printStackTrace () ee If you can’t recover from the exception, at LEAST 
stack trace using the PrintStack Trace() method eral ° 


exceptions inherit. 
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checked and unchecked exceptions 


The compiler checks for everything 
except RuntimeExceptions. 


Exceptions that are NOT subtlasses of 
RuntimeExeeption are checked for by 


the compiler. They're called “checked 
exceptions.” 


@ 


Exception 


The Compiler guarantees: 


If you throw an exception in your code, you must declare it using 
the throws keyword in your method declaration. 


@ If you call a method that throws an exception (in other words, 
a method that declares it throws an exception), you must 
acknowledge that you're aware of the exception possibility. 
One way to satisfy the compiler is to wrap the call in a try/catch. 
(There’s a second way we'll look at a little later in this chapter.) 


1OException InterruptedException 


RuntimeException 


Lions ave NOT theeked by the 


Runti wn eExcer 


\ They re oe co we 

ilew- » , Caten 

aie a ve xteptions: You tan throw fat 
uncherte Exceptions, but yu 


clare Runtime : 
i ‘ and the compiler wort check 
ave H) 


Known as ( 


ClassCastException 


NullPointerException 


there, are_no 


Dumb Questions 


: Wait just a minute! How come this is the FIRST time 
we've had to try/catch an Exception? What about the 
exceptions I’ve already gotten like NullPointerException 
and the exception for DivideByZero? | even got a 
NumberFormatException from the Integer.parselnt() 
method. How come we didn’t have to catch those? 


A: The compiler cares about all subclasses of Exception, 
unless they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 

free pass. RuntimeExceptions can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn’t bother checking whether a method 
declares that it throws a RuntimeException, or whether the 
caller acknowledges that they might get that exception at 
runtime. 
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: I'll bite. WHY doesn’t the compiler care about those 
runtime exceptions? Aren't they just as likely to bring the 
whole show to a stop? 


A: Most RuntimeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You cannot guarantee the server 
is up. But you can make sure your code doesn't index off the 
end of an array (that’s what the .length attribute is for). 


You WANT RuntimeExceptions to happen at development 
and testing time. You don’t want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn't happen in the first place. 


A try/catch is for handling exceptional situations, not flaws 
in your code. Use your catch blocks to try to recover from 
situations you can't guarantee will succeed. Or at the very 
least, print out a message to the user and a stack trace so 
somebody can figure out what happened. 


-—— BULLET POINTS 


exception handling 


tree.) 


both of those things). 


a new exception object: 


ducking a little later in this chapter. 


Amethod can throw an exception when something fails at runtime. 


An exception is always an object of type Exception. (This, as you 
remember from the polymorphism chapters (7 and 8), means the 
object is from a class that has Exception somewhere up its inheritance 


The compiler does NOT pay attention to exceptions that are of 
type RuntimeException. A RuntimeException does not have to be 
declared or wrapped in a try/catch (although you're free to do either or 


All Exceptions the compiler cares about are called “checked 
exceptions,” which really means compiler-checked exceptions. Only 


RuntimeExceptions are excluded from compiler checking. All other 
exceptions must be acknowledged in your code. 


Amethod throws an exception with the keyword throw, followed by 


throw new NoCaffeineException () ; 


Methods that might throw a checked exception must announce it with 
athrows SomeException declaration. 


If your code calls a checked-exception-throwing method, it must 
reassure the compiler that precautions have been taken. 


If you’re prepared to handle the exception, wrap the call in a try/catch, 
and put your exception handling/recovery code in the catch block. 


If you’re not prepared to handle the exception, you can still make the 
compiler happy by officially “ducking” the exception. We'll talk about 


stive tiP 
metacoGnitiv' : 
\f you're trying to learn sla He 
make that the last thing you try bear 
before going to sleep. So, sie oe Lee 
book down (assuming you can 
pu Meanie pack of a ' 
eds time to process wha 
d. That could take 
you try to shove lanes 
top of your Java, some 0 

t “stick.” 


you ve read an 
4 few hours. If 
new in right on 
the Java might no 


esn't rule out learning 
orking on your latest 
oxing routine 

our Java 


Of course, this = 

hysical skill. 
“ee Ballroom KickB 
probably won't affect y 
learning. 


For the best results, read this 
book (or at least look at 
the pictures) right before 
going to sleep. 


________@. Sharpen your pencil 
ere yer 


Which of these do you think 
might throw an exception 
that the compiler should care 
about? These are things that 
you CAN'T control in your code. 
We did the first one. 


(Because it was the easiest.) 


—-» Yours to solve. 


Things you want to do 


connect to a remote server 

__ Access an array beyond its length 
__ Display a window on the screen 
__ Retrieve data from a database 


__ See if a text file is where you think it is 


__ Create a new file 


__ Read a character from the command line 


What might go wrong 


The server is down 


youarehere> 431 


exceptions and flow control 


Flow control in try/catch blocks 


When you call a risky method, one of two things can happen. 
The risky method either succeeds, and the try block completes, 
or the risky method throws an exception back to your calling 
method. 


If the try Succeeds 


(doRiskyThing() does not 
throw an exception) 


try { 
@ Foo f = x.doRiskyThing(); The code in the 
dime 1) = i ,6SeNenn() 2 eateh block never 
S) 
First the ey eee runs. 
then the Code Der } catch (Exception e) { $java Tester 
catth runs: System.out.printin ("failed") ; We made it! 
} 
System.out.printin("We made it!"); 
If the try fails 
(because doRiskyThing() 
does throw an exception) 
try { The vest of 
in 
eee Foo £ = x.doRiskyThing(); "sor th 
Le Ri yey Tring? throws int b = f.getNum(); ae 
3 
eall to don es 
eeprom so ne® F 7 ; 7 
ae i block doesn © run. } catch (Exception e) { 
the ory eee den System. out .printin ("failed") ; sjava Tester 
The catth volo Linues oF } failed 
hod Contin” ; ; 
dhe me System.out.printin("We made it!"); We made it! 
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Finally: for the things you want 
to do no matter what 


If you try to cook something, you start by turning on 
the oven. 


If the thing you try is a complete failure, 


you have to turn off the oven. 


If the thing you try succeeds, 
you have to turn off the oven. 


You have to turn off the oven no matter 
what! 


A finally block is where you put 
code that must run regardless 
of an exception. 


try { 
turnOvenoOn (); 
x.bake(); 

} catch 
e.printStackTrace(); 

} finally { 
turnOvenOfft (); 

} 


(BakingException e) { 


Without finally, you have to put the turnOvenOfff) 
in both the try and the catch because you have to 
turn off the oven no matter what. A finally 
block lets you put all your important cleanup code 
in one place instead of duplicating it like this: 


try { 
turnOvenoOn (); 
x.bake(); 
turnOvenOfft (); 

} catch 
e.printStackTrace(); 
turnOvenOff (); 


(BakingException e) { 


exception handling 


Whatever happens, don't 
forget to put the handbrake 
on when we stop. We never 

found out where the last car 
ended up... 


If the try block fails (an exception), flow 
control immediately moves to the catch block. 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 


If the try block succeeds (no exception), 
flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 


If the try or catch block has a return 
statement, finally will still run! Flow 
jumps to the finally, then back to the return. 
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flow control exercise 


—@aSharpen your pencil 
ere yer P 


—-+> Your’ to solve. 


Look at the code to the left. What do you think the 


Flow Control output of this program would be? What do you think 
it would be if the third line of the program were 
changedto String test = "yes";? 


Assume ScaryException extends Exception. 


public class TestExceptions { 
Output whentest = "no" 
public static void main(String[] args) { 
String test = "no"; 
try { 
System.out.println ("start try") ; 
doRisky (test) ; 
System.out.println ("end try") ; 
} catch (ScaryException se) { 
System.out.println("scary exception") ; 
} finally { 
System. out.println ("finally") ; 
} 


System.out.println ("end of main") ; 


static void doRisky(String test) throws ScaryException { Output whentest = "yes" 
System.out.println ("start risky") ; 
if ("yes".equals(test)) { 
throw new ScaryException () ; 


} 
System.out.println ("end risky") ; 


class ScaryException extends Exception { 


} 


ulew Jo pua - Ajjeuy - uoIdadxa Aleds - Aysu yeys - Al} YeXs :,S9A,, = S98} UBUM\ 
ulew jo pua - Ayeuy - As} pua - Aysu pua - Aysi yes - Al} WeJs :,0U, = 159} UdUM 
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exception handling 


Vid we mention that a method can 
throw wore than one exception? 


A method can throw multiple exceptions if it darn well needs to. But a method’s 
declaration must declare all the checked exceptions it can throw (although if two 
or more exceptions have a common superclass, the method can declare just the 
superclass). 


Catching multiple exceptions 


The compiler will make sure that you’ve handled all the checked exceptions 
thrown by the method you're calling. Stack the catch blocks under the fry, one 
after the other. Sometimes the order in which you stack the catch blocks matters, 
but we'll get to that a little later. 


public class Laundry { 4 aw’ 


public void doLaundry() throws PantsException, LingerieException { 
// code that could throw either exception iN h 


+a "em, 
} ekhod declares tuo, Coun 
This ™ ; 
TWO extertion® 
public class WashingMachine { 
public void go() { 
Laundry laundry = new Laundry(); If doLaundry() throws a 
try { PantsExteption, it lands in the 
laundry.doLaundry(); PantsException catch block. 
} catch (PantsException pex) { 
// recovery code 
} catch (LingerieException lex) { 4 
// recovery code NL \f goL-aundry” Lpyrows cae 
} LingerieErcer™ a ck 
. otk. 
} Lingerie xeertin ial 
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polymorphic exceptions 


Exceptions are polymorphic 


Exceptions are objects, remember. There’s nothing all that special 
about one, except that it is a thing that can be thrown. So like all 
good objects, Exceptions can be referred to polymorphically. 

A LingericException object, for example, could be assigned to a 
ClothingException reference. A PantsException could be assigned 
to an Exception reference. You get the idea. The benefit for 
exceptions is that a method doesn’t have to explicitly declare every 
possible exception it might throw; it can declare a superclass of the 
exceptions. Same thing with catch blocks—you don’t have to write 
a catch for each possible exception as long as the catch (or catches) 
you have can handle any exception thrown. 


@) You can DECLARE exceptions using a 
superclass of the exceptions you throw. 


i 


public void doLaundry() throws ClothingException { 


@ You can CATCH exceptions using a 
superclass of the exception thrown. 


try { 
laundry.doLaundry (); 


Can eaten any 
Clothingeecer er 


EB ; nN 4 vw sutlass 
f Qs Vb 


} catch (ClothingException cex) { 
// recovery code 


} 
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Exception 


All exceptions have 


Exception as 4 


super class: 


lOException 


ClothingException 


PantsException 


LingerieException 


ShirtException 


try { 


// recovery code 


bs 


TeeShirtException 


DressShirtException 


exception handling 


Just because you CAN catch everything 
with one big super polymorphic catch, 
doesn’t always mean you SHOULD. 


You could write your exception-handling code so that you 
specify only one catch block, using the superclass Exception 
in the catch clause, so that you'll be able to catch any excep- 
tion that might be thrown. 


try { Lyom WHAT? This eateh block 
laundry.doLaundry(); Retovery trom teptions, So YO wont 
} catch (Exception ex) { eateh ANY and all ex i ent, wont 
// vecovery code... Guo automatically know what W 
} 


Write a different catch block for each 
exception that you need to handle 
uniquely. 


For example, if your code deals with (or recovers from) 

a TeeShirtException differently than it handles a 
LingerieException, write a catch block for each. But if you treat 
all other types of ClothingException in the same way, then add 
a ClothingException catch to handle the rest. 


try { 
laundry.doLaundry () ; 


Ee ue and k 
; Exterior : (feren 
} catch (TeeShirtException tex) {¢—~ TeeShiree pions need i. g vse 
// vecovery from TeeShirtException ue e, so 
Love ! 
. (Leven earth vile 
\ 


} catch (LingerieException lex) { 


// vecovery from LingerieException 


Th 
qi i \Y All other Clothin 


} catch (ClothingException cex) { are Caught here. 


9Exceptions 


// recovery from all others 
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order of multiple catch blocks 


Multiple catch blocks must be ordered 


from smallest to biggest 


Sa. rons are 
bs First ; Teer OT no other 


catch (ShirtException sex) 


catch (ClothingException cex) 
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ClothingException 


PantsException 


LingerieException 


ShirtException 


UniformException 


bo 


TeeShirtException 


piueting 


DressShirtException 


The higher up the inheritance tree, the bigger the catch 
“basket.” As you move down the inheritance tree, toward 
more and more specialized Exception classes, the catch 
“basket” is smaller. It’s just plain old polymorphism. 


A ShirtException catch is big enough to take a 
TeeShirtException or a DressShirtException (and any 
future subclass of anything that extends ShirtException). 
A ClothingException is even bigger (1.e., there are more 
things that can be referenced using a ClothingException 
type). It can take an exception of type ClothingException 
(duh) and any ClothingException subclasses: 
PantsException, UniformException, LingericException, 
and ShirtException. The mother of all catch arguments 
is type Exception, it will catch any exception, including 
runtime (unchecked) exceptions, so you probably won’t 
use it outside of testing. 


You cant put bigger baskets 
above smaller baskets 


Well, you can, but it won’t compile. Catch blocks 
are not like overloaded methods where the best 
match is picked. With catch blocks, the JVM 
simply starts at the first one and works its way 
down until it finds a catch that’s broad enough 
(in other words, high enough on the inheritance 
tree) to handle the exception. If your first 

catch block is catch (Exception ex), the 
compiler knows there’s no point in adding any 
others—they’ll never be reached. 


bast 


try { 


laundry.doLaundry (); 


6 A Plumbing 


———— 


} catch(ClothingException cex) { 
// vecovery from ClothingException 


} catch(LingerieException lex) { 
// recovery from LingerieException 


} catch(ShirtException shex) { 
// recovery from ShirtException 


} 


exception handling 


Size matters when 
you have multiple catch 
blocks. The one with the biggest 
basket has to be on the bottom. 
Otherwise, the ones with 
smaller baskets are useless. 


Siblings (exceptions at the same level of 
the hierarchy tree, like PantsException 
and LingerieException) can he in any 
order, because they can’t catch one 
another's exceptions. 


You could put ShirtException above 
LingericException, and nobody would mind. 
Because even though ShirtException is a bigger 
(broader) type because it can catch other classes 
(its own subclasses), ShirtException can’t catch a 


LingericException, so there’s no problem. 
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polymorphic puzzle 


Assume the try/catch block here is legally coded. Your task is to draw two 


G harpen your pencil different class diagrams that can accurately reflect the Exception classes. 


In other words, what class inheritance structures would make the try/ 
catch blocks in the sample code legal? 


try { 
x.doRisky () ; 
} catch (AlphaEx a) { 
// recovery from AlphaEx 
} catch(BetaEx b) { 
// recovery from BetaEx 


} catch (GammaEx c) { 
// recovery from GammaEx 
} catch (DeltaEx d) { 
// recovery from DeltaEx 


} 

Your task is to create two different /egal try/catch structures (similar to the 
one above left) to accurately represent the class diagram shown on the 
left. Assume ALL of these exceptions might be thrown by the method with 

BazEx the try block. 

FooEx 

BarEx Biffx 
BoinkEx 
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exception handling 


When you don’t want to handle 
an exception... 


What the...? 


There is NO way I'm 
catching that thing. I'm gettin’ 
out of the way—somebody 
behind me can handle it. 


If you don’t want to handle an 
exception, you can duck it by 
declaring it. 


When you call a risky method, the compiler needs 
you to acknowledge it. Most of the time, that 
means wrapping the risky call in a try/catch. But 
you have another alternative: simply duck it and let 
the method that called you catch the exception. 


It’s easy—all you have to do 1s declare that_you throw 
the exceptions. Even though, technically, you aren’t 
the one doing the throwing, it doesn’t matter. 
You're still the one letting the exception whiz right 
on by. 


But if you duck an exception, then you don’t 
have a try/catch, so what happens when the risky 
method (doLaundry()) does throw the exception? 


When a method throws an exception, that method 
is popped off the stack immediately, and the 
exception is thrown to the next method down the 
stack—the caller. But if the caller is a ducker, then 
there’s no catch for it, so the caller pops off the 
stack immediately, and the exception is thrown to 
the next method and so on...where does it end? 
You'll see a little later. 


epti 1 ) but 
IE x¢ ef ou don \a 

| { sine yor ae h \ a eaten 
(4 . a "4 method: 


// call risky method without a try/catch Yolk ave now gone You 
laundry .doLaundry () ; Be ith Lhe exterior 
has 
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handle or declare 


Ducking (by declaring) only 
delays the inevitable 


Sooner or later, somebody has to 
deal with it. But what if main() 
ducks the exception? 


public class Washer { 
Laundry laundry = new Laundry(); 


public void foo() throws ClothingException { 
laundry.doLaundry () ; 


} 


public static void main (String[] args) throws ClothingException { 
Washer a = new Washer(); 


a.foo()+ 
} 
} 


doLaundry() throws a 


ClothingException 


foo() ducks the 


san (0 
ne erter ee : 
4) as dul Me ooo} 
Porth wer 1, go LHe’ ust Kine 
gevler" en + \ws com@nes ) 
andl 
main() ducks the The JVM 
exception shuts down 


main() calls foo() 


foo() calls doLaundry() 


doLaundry() is 
running and throws a 
ClothingException 


¢ eas , We’re using the T-shirt to represent a Clothing 


Mined 
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doLaundry() pops off the 
stack immediately, and 
the exception is thrown 


But foo() doesn't have a 
try/catch, so... 


Exception. We know, we know...you would have 
preferred the blue jeans. 


foo() pops of f the 
stack, and the excep- 
tion is thrown back 

to main(). But main() 
doesn't have a try/ 
catch, so the excep- 
tion is thrown back to... 
who? What? There's 
nobody left but the 
JVM, and it's thinking, 
“Don't expect ME to 
get you out of this." 


exception handling 


Handle or Declare. It’s the law. 


So now we’ve seen both ways to satisfy the compiler 
when you call a risky (exception-throwing) method. 


@ HANDLE 


Wrap the risky call ina try/catch This had better be 


a bi 
try { handle all exceptionc due nna” Catth to 
laundry.doLaundry(); ae a exceptions that dol_aundry() 


might throw. 
} catch (ClothingException cex) { _ sfjl] eae reyes we will 
not Catching all 


// recovery code he except 
ons. 


@ DECLARE (duck it) 


Declare that YOUR method throws the same exceptions 


‘ ‘ i a. 
as the risky method you're calling. The goL-aundry by declaring the 


: jon, OV 
void foo() throws ClothingException { Clothinge*Ce C00 method gets 
laundry.doLaundry () ; T___ exception THe o try/e 
juck tre excerun 
But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If foo() ducks 
the exception (by declaring it) and main() calls foo(), then 
main() has to deal with the exception. 
public class Washer { 
Laundry laundry = new Laundry(); 
public void foo() throws ClothingException { 
laundry.doLaundry(); 
} TROUBLE! 
) Lompiles an 
public static void main (String[] args) { Now engin) - i extegcion 
Washer a = new Washer (); & nirePOw e 
a.foo(); ~~ get an he fae 38 ne come” ‘i bows 
} error 1 Loot) metho 
} Because th f. (0) cerned ne 
¢ tool) method ducks the ton hin 
ClothingExeeption heen 1 wn CXLeR UO 


Y doLaundr (), . 
main() has to wrap afool) in g Eesriate, 


or main() has to declare that it, too, 
throws ClothingException! . 
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fixing the Sequencer code 


Getting back to our music code... 


Now that you’ve completely forgotten, we started this chapter with a 
first look at some JavaSound code. We created a Sequencer object, but 
it wouldn’t compile because the method Midi.getSequencer() declares 
a checked exception (MidiUnavailableException). But we can fix that 


now by wrapping the call in a try/catch. 


public void play() { 
try { 


Sequencer sequencer = MidiSystem.getSequencer (); 


System.out.printin("Successfully got a sequencer") ; 


« ” Cateh 
} catch (MidiUnavailableException e) { right” . 


System.out.printin("Bummer") ; 


} 


Exception Rules 


@) You cannot have a catch or finally 


without a try. 
void go() { 


NOT LEGAL 
the bey? 


Foo £f = new Foo(); ; 
s 
£.fOOT () 4 Where 


catch (FooException ex) { } 


You cannot put code between the 
try and the catch. 


NOT LE 
try { "You tan’ 
é a) 
x. doStuff () ; ode betweer the tr dee 
; the eaten, Y and 
int y = 43; 
} catch(Exception ex) { } 
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ec 


@ A try MUST be followed by either a 
catch or a finally. LEGA, 
b 


(04 
try { have af; ia You 
x.doStuff(); though 4 Y even 
} finally { Cate B, Cre’s ho 
// cleanup have a¢ You Cannot 
b 


} ef y itself 


@ Atry with only a finally (no catch) 


must still declare the exception. 


void go() throws FooException { 


try { . ka catth 
x.doStufé () ; i try oe the 
} finally { } doesnt sacist 


m + 
x Code Kitchen 


Vi 


Everything 
you see I made 
myself from scratch. 


Was that more 
satisfying than 
using Ready-Bake 
Code? 


exception handling 


You don’t have to do it 
yourself, but it’s a lot 
more fun it you do. 


The rest of this chapter 


is optional: you can use 
Ready-Bake Code for all 
the music apps. 


But if you want to learn 
more about JavaSound, 
turn the page. 
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JavaSound MIDI classes 


Making actual sound 


Remember near the beginning of the chapter, we looked at how MIDI data holds the 
instructions for what should be played (and how it should be played) and we also said 
that MIDI data doesn’t actually create any sound that _you hear. For sound to come out of the 
speakers, the MIDI data has to be sent through some kind of MIDI device that takes 
the MIDI instructions and renders them in sound, by triggering either a hardware in- 
strument or a “virtual” instrument (software synthesizer). In this book, we’re using only 
software devices, so here’s how it works in JavaSound: 


You need FOUR things: 


The thing that 
plays the music 


The music to be 


The part of the OC) The actual music 
played...a song. 


Sequence that information: notes 
holds the actual to play, how long, 
information etc. 


plays has a holds 


Sequencer Sequence Track | 


For this book, all we S&S 
want to do will fit on a 
single track, so for us 
one song needs only 
one track. This Track 
is where all the song 
The Sequence is the data (MIDI information) 
song, the single piece lives. 
of music that the 
Sequencer will play. 


The Sequencer is the thing 
that actually causes a song 
to be played. Think of it like 


a smart speaker streaming . 
music A MIDI event is a message 


that the Sequencer can 
understand. A MIDI event 
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eas 3 might say (if it spoke 
ok ‘he — The English), “At this moment 
Kis ook one Track in time, play middle C, play 
For (has on \ay Lhe son it this fast and this hard, 
ginaie“s0n8 govt ho ok Teatk ¥s yar and hold it for this long. “ 
norma? cats and the A MIDI event might 
\wes o” ‘i also say something like, 


“Change the current 
instrument to Flute.” 


And you need FIVE steps: 


@) Get a Sequencer and open it 


Sequencer player = MidiSystem.getSequencer () ; 


player.open(); 


@) Make a new Sequence 


Sequence seq = new Sequence (timing, 4); 


@ Get anew Track from the Sequence 


Track t = seq.createTrack(); 


@ Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 


t.add(myMidiEventl1) ; 
player.setSequence (seq) ; 


Uh, hate to break it 
to you, but that's only 
FOUR steps. 


exception handling 


Ahhhh. We 
forgot to push the 

PLAY button. You have to 

start() the Sequencer! 


player.start(); 
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a sound application 


Version 1: Your very first sound player app 


Type it in and run it. You'll hear the sound of someone playing a single 
note on a piano! (OK, maybe not someone, but something.) 


Don’t £o 
rae n't £. rget to import the wid 


import javax.sound.midi.*; Package. 
import static javax.sound.midi.ShortMessage. *; We've using, a statie import here so we Can 
ee ae ctants in the ShortMessage Class: 
public class MiniMiniMusicApp { use the Con 
public static void main(String[] args) { 
MiniMiniMusicApp mini = new MiniMiniMusicApp() ; 
mini.play (); 
} 


oren it 


on 
G ek 3 Gequente* 3 Gequente’ 
public void play() { tan vse 10" a 
_ Lo (so We ne aveady OF 
1L Gom 
@ Sequencer player = MidiSystem.getSequencer () ; goesn 
player.open() ; Le’ 


Sequence seq = new Sequence (Sequence.PPQ, 4) ; Sequente vis 
(think ok em a8 


Track track = seq.createTrack();¢____ Ask the Sequence for a Track. Remember die 


Track lives in the Se 
lives 3 the Trak quence, and the MID] data 


ShortMessage msgl = new ShortMessage () ; 


msgl.setMessage(NOTE_ON, 1, 44, 100); Put some MidiEvents the 
MidiEvent noteOn = new MidiEvent(msgl1, 1); Track. This part is mostly Ready. 
track .add(noteOn) ; Bake Code. The ely thing yaull 


ShortMessage msg2 = new ShortMessage () ; have to care about ave the 
msg2.setMessage (NOTE OFF, 1, 44, 100); arguments to the setMessage() 
MidiEvent noteOff = new MidiEvent(msg2, 16) ; method, and the arguments to the 
track .add(noteOff) ; MidiEvent constructor. We'll look sh 
those arguments on the next page. 


player. setSequence (seq) ; C— Give the Sequence to the Sequencer (like 
selecting the song to play). 


player.start() ; —_ star£() the Sequene 
néer 


catch (Exception e) { 
e.printStackTrace () ; 


od 


} 


} 
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Making a Miditvent (song data) 


A MidiEvent is an instruction for part of a song. A series of MidiEvents is kind 
of like sheet music, or a player piano roll. Most of the MidiEvents we care about A MidiEvent Says 


describe a thing to do and the moment in time to do it. The moment in time | di | | 
part matters, since timing is everything in music. This note follows this note and so what to 0) Vhen 


on. And because MidiEvents are so detailed, you have to say at what moment to to do tt. 

start playing the note (a NOTE ON event) and at what moment to stop playing the 

notes (NOTE OFF event). So you can imagine that firing the “stop playing note mst D 

G” (NOTE OFF message) before the “start playing Note G” (NOTE ON) message Every Tuction 
wouldn’t work. must include the 
The MIDI instruction actually goes into a Message object; the MidiEvent is a timing for that 


combination of the Message plus the moment in time when that message should 7‘ : 
“fire.” In other words, the Message might say, “Start playing Middle C,” while the mstTuction. 
MidiEvent would say, “Trigger this message at beat 4.” 


So we always need a Message and a MidiEvent. In other words, 
The Message says what to do, and the MidiEvent says when to do it. at which beat that 


thing should happen. 


@ Make a Message 


ShortMessage msg = new ShortMessage(); 


» 


@) Put the Instruction in the Message chart playing note 
IS) 
msg.setMessage(144, 1, 44, 100); oe other numbers on e 
(we'll loo 
next page): 


@) Make anew MidiEvent using the Message 


MidiEvent noteOn = new MidiEvent(a, 1); 


The instructions ave j 
-_ n the messa e, but th 
m Event. adds the moment in ee 
ins i e 
@) Add the MidiEvent to the Track am ia ee be triggered. This MidiEvent says 
aie eeteoaie ~~ Jer message ‘a’ at the first beat (beat |). 


A Track holds all the MidiEvent objects: racer ore 
i £ is suppose appen, 
m according to when each even 

o een them back in that order. You i eae 

vents happening at the exact same moment in time. For arnle 
: iaht want two notes played simultaneously, or even a 

is ime. 
T hconrt playing, different sounds at the same time 
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contents of a Midi event 


MIDI message: the heart of a MidiEvent 


A MIDI message holds the part of the event that says what to do. It’s the actual instruction you 
want the sequencer to execute. The first argument of an instruction is always the type of the 
message. The values you pass to the other three arguments depend on the type of message. For 
example, a message of type 144 means “NOTE ON.” But in order to carry out a NOTE ON, the 
sequencer needs to know a few things. Imagine the sequencer saying, “OK, Pll play a note, but 
which channel? In other words, do you want me to play a Drum note or a Piano note? And which 
note? Middle-C? D Sharp? And while we’re at it, at which velocity should I play the note? 


To make a MIDI message, make a ShortMessage instance and invoke setMessage(), passing in the 
four arguments for the message. But remember, the message says only what to do, so you still need 
to stuff the message into an event that adds when that message should “fire.” 


Anatomy of a message The Message says what to do: the 
The first argument to setMessage() always sds ‘ 
represents the message “type,” while the other MidiEvent Say! 5 when to do it. 


three arguments represent different things 
depending on the message type. 


ot wi s @ Channel 
oe yore gl Think of a channel like a musician in 
msg.setMessage(144, 1, 44, 100); a band. Channel 1 is musician 1 (the 
The | keyboard player), channel 9 is the 
Abe ee 9°98 vary dependin drummer, etc. 
the other: This isa NOTE Dy 
as er args are for th; m Sage, so 
eds to k ings the 


F g 
new m order to Play a» aad ® Note to play 


ote. 


A number from O to 127, going 
from low to high notes. 


@) Message type 


144 means 
NOTE ON 


Xe 
stan 
ton 
128 Hgts You Ca” use Teel / / 
T in Show i 

NOTE OFF values . wpanin * | @ Velocity Fr 
insted ber numbers) © How fast and hard did you press the 
cemernde S -NoTe_O*: key? 0 is so soft you probably won't hear 

ghortMessa9 anything, but 100 is a good default. 
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Change a message 


Now that you know what’s in a MIDI message, you can start experimenting. You can 
change the note that’s played, how long the note is held, add more notes, and even 
change the instrument. 


@) Change the note 


Try a number between O and 127 in the note 
onand note off messages. 


msg.setMessage(144, 1, 20, 100); \ 


@) Change the duration of the note 
Change the note off event (not the message) so 
that it happens at an earlier or later beat. 
msg.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent (b, 3); 


— 


\ 


\ 


@) Change the instrument 


Add a new message, BEFORE the note-playing message, 
that sets the instrument in channel 1 to something other 
than the default piano. The change-instrument message 
is "192," and the third argument represents the actual 
instrument (try a number between O and 127). 


first. setMessage(192, 1, 102, 0); 


ob 
oF se gt 
ra \ (or oom 
oo sear? xp 
of we 
ot 
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change the instrument and note 


Version 2: Using command-line args to experiment with sounds 


This version still plays just a single note, but you get to use command-line arguments to 
change the instrument and note. Experiment by passing in two int values from 0 to 127. 
The first int sets the instrument; the second int sets the note to play. 


import javax.sound.midi.*; 
import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicCmdLine { 
public static void main(String[] args) { 
MiniMusicCmdLine mini = new MiniMusicCmdLine(); 
if (args.length < 2) { 
System.out.printlin("Don’t forget the instrument and note args"); 


} else f{ 
int instrument = Integer.parselInt (args[0]); 
int note = Integer.parselInt(args[1]); 


mini.play(instrument, note); 


public void play(int instrument, int note) { 
cry { 
Sequencer player = MidiSystem.getSequencer () ; 
player.open (); 
Sequence seq = new Sequence (Sequence.PPQO, 4); 
Track track = seq.createTrack(); 


ShortMessage msgl = new ShortMessage(); 
msgl.setMessage (PROGRAM CHANGE, 1, instrument, 0); 
MidiEvent changeInstrument = new MidiEvent(msgl, 1); 


track.add(changeInstrument) ; 


ShortMessage msg2 = new ShortMessage() ; 
msg2.setMessage (NOTE ON, 1, note, 100); 
MidiEvent noteOn = new MidiEvent(msg2, 1); 
track.add(noteOn) ; 


Run it with two int args from O 
ShortMessage msg3 = new ShortMessage(); to 127. Try these for starters: 


ee 
MidiEvent noteOff = new MidiEvent (msg3, 16); 


track.add(noteOff) ; Sjava MiniMusicCmdLine 102 30 


$java MiniMusicCmdLine 80 20 


player.setSequence (seq) ; 
player.start(); $java MiniMusicCmdLine 40 70 


} catch (Exception ex) { 
ex.printStackTrace(); 
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Where we're headed with the rest 
of the CodeKitchens 


eee Cyber BeatBox 
Chapter 17: the goal pace Be, 
When we're done, we'll have a working eas Tempo Up 
BeatBox that's also a Drum Chat Client. Crash Cymbal Tempo Down 
We'll need to learn about GUIs (includ- sales sendit 
ing event handling), I/O, networking, and Hi Bongo 
threads. The next three chapters (14,15, | \neue 
and 16) will get us there. Low Conga sna guoe¥ 


Cowbell 
Vibraslap Brooklyn: groove2 revised 
Low=mid Te = 

eet BoomTish: dance beat 
High Agogo 


Open Hi Conga 


Chapter 14: MIDI events 


This CodeKitchen lets us build a little 
“music video" (bit of a stretch to call it 
that...) that draws random rectangles to 
the beat of the MIDI music. We'll learn 
how to construct and play a lot of MIDI d z z 
events (instead of just a couple, as we do beat one beat two beat three beat four 
in the current chapter). 


eee Cyber BeatBox 

Chapter 15: Standalone oan stan 
josed Hi-Hal Stop 

Open Hi-Hat 

BeatBox Acoustic Snare Q Tempo Up_ 
' ‘ Crash Cymbal Tempo Down 

Now we'll actually build the real BeatBox, Hand Clap 
GUI and all. But it's limited—as soon as you — ‘is*Tm 


Hi Bongo 


change a pattern, the previous one is lost. Maracas 
There's no Save and Restore feature, and Ccieds 


Low Conga 


it doesn't communicate with the network. Cowbell 
(But you can still use it to work on your ee ee 
drum pattern skills.) High Agogo 


Open Hi Conga 


ete 


eee Cyber BeatBox 
Bass Drum Start 
Chapter 16: Save and Closed Hi-Hat 
Open Hi-Hat 
Restore ees Taree 
Crash Cymbal Tempo Down 
You've made the perfect pattern, and now yond clon serializelt 
: . . High Tom westore 
you can save it toa file and reload it when —_—titongo 
you want to play it again. This gets us ae 
4 5 Whistle 
ready for the final version (Chapter 15), Low Conga 
where instead of writing the pattern toa ae 
file, we send it over a network to the chat tenement 
server. eee 
Open Hi Conga 


2here> 453 


exercise: True or False 


This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or false. 


Trve or Fatse® 


1. A try block must be followed by a catch and a finally block. 


2. If you write a method that might cause a compiler-checked exception, you must wrap 
that risky code in a try/catch block. 


3. Catch blocks can be polymorphic. 

4. Only “compiler checked” exceptions can be caught. 

5. If you define a try/catch block, a matching finally block is optional. 

6. If you define a try block, you can pair it with a matching catch or finally block, or both. 


7. If you write a method that declares that it can throw a compiler-checked exception, 


you must also wrap the exception throwing code in a try/catch block. 

8. The main( ) method in your program must handle all unhandled exceptions thrown to it. 
9. A single try block can have many different catch blocks. 

10. A method can throw only one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself; without a catch block or a finally block. 

14, Handling an exception is sometimes referred to as “ducking.” 

15. The order of catch blocks never matters. 


16. A method with a try block and a finally block can optionally declare a 


checked exception. 


17. Runtime exceptions must be handled or declared. 


————> Answers on page 457. 
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( 225 y 
RS 
<=) Code Magnets 
A working Java program is scrambled up on the fridge. Can you reconstruct 
all the code snippets to make a working Java program that produces the 


output listed below? Some of the curly braces fell on the floor and they 
were too small to pick up, so feel free to add as many of those as you need! 


System.out.print ("r")i 


System. out. print ("tm") , 


doRisky (test); 


"); 


System.out.printin("s 


System.out.print("o"); 


class MyEx extends Exception { } 


public class ExTestDrive { 


gystem.out print ("Ww"); 


leet ("yesgu 


-€quals (t)) { 


System.out.print ("a"); 


throws MyEx { 


static void doRisky(String t) 


System.out.print ("h"); 


File Edit Window Help ThrowUp 


% java ExTestDrive yes 
thaws 


d main(String [] args) { 


public static voi 


String test = args[0]; 


% java ExTestDrive no 
throws 


—— 
Answers on page 458. youarehere> 455 


puzzle: crossword 


JavaCress 


> Answers on page 459. 


Across 

1. To give value 

4. Flew off the top 
6. All this and more! 
8. Start 

10. The family tree 
13. No ducking 

15. Problem objects 


18. One of Java's ‘49’ 


20. Class hierarchy 

21. Too hot to handle 

24. Common primitive 
25. Code recipe 

27. Unruly method action 
28. No Picasso here 


29. Start a chain of events 


Down 

2. Currently usable 

3. Template's creation 
4. Don't show the kids 
5. Mostly static API class 
7. Not about behavior 
9. The template 


11. Roll another one off 


More Hints: 
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ayab, e1ON ‘ZL 
UNO, AjlwWey ayy ‘OL 
ynejap Jo a1qGnd Aju *6 


the line 
“** SJOQUINN °S 
(a|}dwexa jou) 404 °€ 
YsemyInow 210 ‘7 
umoqg 


12. Javac saw it coming 
14, Attempt risk 

16. Automatic acquisition 
17. Changing method 


19. Announce a duck 


22. Deal with it 
23. Create bad news 


26. One of my roles 


PeSGY ION “87 

wa|qoid e syeys "77 

eNO “LZ 

UOIIDA|]OD Jo adA} e OS] “OZ 


You know what 
to do! 


auejpap Jo peaysu “€1 
poujaw e eis “g 
Pyry> eae *9 
SSOADY 


§ ou: HH on DeltaEx 
G harpen your pencil 
IN 
(from page 440) 
GammaEx 
BetaEx 
AlphaEx 
Exercise Solution 


Trve OR False (from page 454) 


— 


. False, either or both. 
. False, you can declare the exception. 
True. 

False, runtime exception can be caught. 
. True. 
. True, both are acceptable. 
. False, the declaration is sufficient. 


. False, but if it doesn’t, the JVM may shut 
down. 


9. ‘True. 


exception handling 


DeltaEx 


BetaEx GammaEx 


AlphaEx 


10. False. 


11. True. It’s often used to clean up partially 
completed tasks. 


12. False. 
13. False. 
14. False, ducking is synonymous with declaring. 


15. False, broadest exceptions must be caught by 
the last catch blocks. 


16. False, if you don’t have a catch block, you 
must declare. 


17. False. 
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exercise solutions 


be» Exercise Solutions 


Code Magnets (from page 455) 


class MyEx extends Exception { } 


public class ExTestDrive { 
public static void main(String[] args) { 

String test = args[0]; 
try { 
System.out.print ("t"); 
doRisky (test); 
System.out.print 
} catch (MyEx e) { 
System.out.print 
} finally { 
System.out.print ("Ww"); 

} 


System.out.printin("s"); 


Co") ; 


("a") ¢ 


static void doRisky(String t) throws My 
System.out.print ("h"); 


ea] 
™ 
~, 


, 


if ("yes".equals(t)) { 
throw new MyEx() 


} 
. File Edit Window Help Chill 
System.out.print ("r"); 
} java ExTestDrive yes 
} thaws 


° 


% java ExTestDrive no 
throws 
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14 getting gui 


A Very Graphic 
Story 


pincard your ee could Wow! This looks great. 


only cook command-line I guess presentation 


meals. really is everything. 


Face it, you need to make GUIs. If you're building applications that other people 
are going to use, you need a graphical interface. If you’re building programs for yourself, you 
want a graphical interface. Even if you believe that the rest of your natural life will be spent 
writing server-side code, where the client user interface is a web page, sooner or later you'll 
need to write tools, and you'll want a graphical interface. Sure, command-line apps are retro, 
but not in a good way. They’re weak, inflexible, and unfriendly. We'll spend two chapters 
working on GUIs and learn key Java language features along the way including Event 
Handling and Inner Classes and lambdas. In this chapter, we'll put a button on the screen, 
and make it do something when you click it. We'll paint on the screen, we'll display a JPEG 


image, and we'll even do some (crude) animation. 
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your first gui 


It all starts with a window 


A JFrame is the object that represents a 
window on the screen. It’s where you put all 
the interface things like buttons, check boxes, 
text fields, and so on. It can have an honest- 
to-goodness menu bar with menu items. 

And it has all the little windowing icons for 
whatever platform you’re on, for minimizing, 
maximizing, and closing the window. 


The JFrame looks different depending on the 
platform you’re on. This is a JFrame on an old 
Mac OS X: 


e090 


File Panic Deviate 


Put widgets in the window 


Once you have a JFrame, you can put things 


(“widgets”) in it by adding them to the JFrame. 


There are a ton of Swing components you 
can add; look for them in the javax.swing 
package. The most common include JButton, 
JRadioButton, JCheckBox, JLabel, JList, 
JScrollPane, JSlider, JTextArea, JTextField, 
and JTable. Most are really simple to use, 

but some (like JTable) can be a bit more 
complicated. 
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Two issues! 
1. Swing? This looks like Swing code. 
You're really gonna teach us Swing? 
2. That window looks really 

old-fashioned. 


She’s asked a couple of really good 
questions. In a few pages we'll ad- 
dress these questions with an extra- 
special “No Dumb Questions.” 


Making a GUI is easy: 
@ Make a frame (a JFrame) 


JFrame frame = new JFrame() ; 


@ Make a widget (button, text field, etc.) 
JButton button = new JButton ("click me") ; 


@ Add the widget to the frame 
frame.getContentPane () .add (button) ; 


around the wi € same as the trim 
ae window, and you add things iL 


@ Display it (give it a size and make it visible) 
frame.setSize (300,300) ; 
frame.setVisible (true) ; 


getting gui 


Your first GUI: a button on a frame 


4 Forget to import 
import javax.swing.*; €— es swing paCke 


public class SimpleGuil { 
public static void main(String[] args) { ¢ cand 3 butter 
am 
make a « to) tonstiruetor 
ass the button 
JFrame frame = new JFrame() ; reall we ie ee want on the button) 


JButton button = new JButton ("click me") ; 


frame .setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE) ; 
this line makes the 

lose the window as 

Just sit there on the 


rogram quit AS Soon as you 
You leave this out it will 


frame .getContentPane() .add (button) ; Streen forever) 


— add the button to the fra ? 
frame.setSize(300, 300); content Pane it 


9ive the frame se 
frame .setVisible (true) ; “'26, in Pixels 


; Finally, make it: visiblell (if 
his step, You won't see 


You run this code) 


Ou forget 


Se€ anything when 


Let’s see what happens when we run it: 
Sjava SimpleGuil 


Whoa! That's a 
Really Big Button. 


The button fills all the 
eae available space in the frame. 
Later we'll learn to control 
where (and how big) the 


button is on the frame. 


| 
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user interface events 


But nothing happens when | click it... 


That’s not exactly true. When you press the button, it shows that 
“pressed” or “pushed in” look (which changes depending on the 
platform look and feel, but it always does something to show when it’s 
being pressed). 


The real question 1s, “How do I get the button to do something specific 
when the user clicks 1t?” 


We need two things: 


® a method to be called when the user 
clicks (the thing you want to happen as 
a result of the button click). 


@a way to Know when to trigger 
that method. In other words, a way 
to know when the user clicks the 
button! 


When the user clicks, we want 
to know. 


We’re interested in the user- 
takes-action-on-a-button event. 
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thereareno 
b Questions 


Q: | heard that nobody uses 
Swing anymore. 


A: There are other options, 

like JavaFX. But there are no clear 
winners in the endless and ongo- 
ing “Which approach should | use 
to make GUls in Java?” debate. The 
good news is that if you learn a little 
Swing, that knowledge will help 
you whichever way you end up go- 
ing. For example, if you want to do 
Android development, your Swing 
knowledge will make learning to 
code Android apps easier. 


Q: Will a button look like a 
Windows button when you run on 
Windows? 


A: If you want it to. You can 
choose from a few “look and 


feels”—classes in the core library 
that control what the interface looks 
like. In most cases you can choose 
between at least two different looks. 
The screens in this book use a 
number of “look and feels,” includ- 
ing the default system look and feel 
(for macOS), the OS X Aqua look and 
feel, or the Metal (cross platform) 
look and feel. 


Q: Isn’t Aqua really old? 


A: Yes, but we like it. 


Getting a user event 


Imagine you want the text on the button to change 
from click me to I’ve been clicked when the user presses 
the button. First we can write a method that changes 
the text of the button (a quick look through the API 
will show you the method): 


public void changeIt() { 
button.setText ("I’ve been clicked!") ; 


} 


But now what? How will we know when this method 
should run? How will we know when the button 
is clicked? 


In Java, the process of getting and handling a user 
event is called event-handling. There are many different 
event types in Java, although most involve GUI user 
actions. If the user clicks a button, that’s an event. 
An event that says “The user wants the action of 
this button to happen.” If it’s a “Slow the Tempo” 
button, the user wants the slow-the-music-tempo 
action to occur. If it’s a Send button on a chat 
client, the user wants the send-my-message action to 
happen. So the most straightforward event is when 
the user clicked the button, indicating they want an 
action to occur. 


With buttons, you usually don’t care about any 
intermediate events like button-is-being-pressed and 
button-is-being-released. What you want to say to 
the button is, “I don’t care how the user plays with 
the button, how long they hold the mouse over it, 
how many times they change their mind and roll off 
before letting go, etc. Just tell me when the user 
means business! In other words, don’t call me 
unless the user clicks in a way that indicates he wants 
the darn button to do what it says it’ll do!” 


getting gui 


First, the button needs to know 
that we care. 


tte button, | care about 
@ ee happens to you. 


—_, 


your code 
6 WW 
“Fton 0% 


ee 


@ The user clicked me! 


Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 


WAIN 
POWER 


1. How could you tell a button object that you 
care about its events? That you're a concerned 
listener? 


2. How will the button call you back? Assume 
that there’s no way for you to tell the button the 
name of your unique method (changelt()). So 
what else can we use to reassure the button that 
we have a specific method it can call when the 
event happens? [hint: think Pet] 
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event listeners 


If you care about the button’s events, 


implement an interface [UEIZE\ES 
aun) listening (a your events.” 


A listener interface is the bridge between the When you implement a 
listener (you) and event source (the button). listener snterface, you 
The Swing GUI components are event sources. In Java terms, an give the button a way 
event source is an object that can turn user actions (click a mouse, to eal] you back. The 


type a key, close a window) into events. And like virtually everything e ° 

else in Java, an event is represented as an object. An object of interface 1§ where the 
some event class. If you scan through the java.awt.event package eal]-back method 1S 

in the API, you'll see a bunch of event classes (easy to spot—they declared. 

all have Event in the name). You'll find MouseEvent, KeyEvent, 


WindowEvent, ActionEvent, and several others. 


An event source (like a button) creates an event object when the 
user does something that matters (like click the button). Most of the 
code you write (and all the code in this book) will recewe events rather 
than create events. In other words, you'll spend most of your time as 


an event listener rather than an event source. 


Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouseListener interface. Want 
WindowEvents? Implement WindowListener. You get the idea. And 
remember your interface rules—to implement an interface you declare 
that you implement it (class Dog implements Pet), which means you “ngiateCh angedi(temever” ev) 


must write implementation methods for every method in the interface. 


Some interfaces have more than one method because the event 
itself comes in different flavors. If you implement Mouse Listener, 
for example, you can get events for mousePressed, mouseReleased, 
mouseMoved, etc. Each of those mouse events has a separate 
method in the interface, even though they all take a MouseEvent. If 
you implement MouseListener, the mousePressed() method is called 
when the user (you guessed it) presses the mouse. And when the user 
lets go, the mouseReleased() method is called. So for mouse events, 


there’s only one event olyect, MouseEvent, but several different event 


methods, representing the different types of mouse events. 
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How the listener and source 
communicate: 


“Button, please add me to 
your list of listeners and call my 
actionPerformed() method when 
the user clicks you." 


aActionLis tene,, 
od Ce, 


x) 
v 
%CtionPerto rmea tne 


The Listener 


If your class wants to know about a 
button’s ActionEvents, you implement 

the ActionListener interface. The button 

needs to know you're interested, so 

you register with the button by calling 
its addActionListener(this) and passing an 
ActionListener reference to it. In our first 
example, you are the ActionListener so you 
pass this, but it’s more common to create 
a specific class to do listen to events. The 
button needs a way to call you back when the 
event happens, so it calls the method in the 
listener interface. As an ActionListener, you 
must implement the interface’s sole method, 
actionPerformed(). The compiler guarantees it. 


"OK, you're an ActionListener, 
so I know how to call you back 
when there's an event—TI'll call 
the actionPerformed() method 
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that I know you have." 


oO 
So 
eee 
click me 
Ho 


The Event Source 


A button is a source of ActionEvents, 
so it has to know which objects are 
interested listeners. The button has an 
addActionListener() method to give 
interested objects (listeners) a way to 
tell the button they're interested. 


When the button’s addActionListener() 
runs (because a potential listener 
invoked it), the button takes the 
parameter (a reference to the listener 
object) and stores it ina list. When 

the user clicks the button, the 

button “fires” the event by calling the 
actionPerformed() method on each 
listener in the list. 
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Getting a button’s ActionEvent 


@ Implement the ActionListener interface 


@ Register with the button (tell it you 
want to listen for events) 


@ Define the event-handling method (implement 
the actionPerformed() method from the 
ActionListener interface) 


. ; : Sor the package . 
import javax.swing.*; hi new import statement, ActionEvent are in- avis 8Y° 
import java.awt.event.*; <— Lyat AttionListener : iver OLE) ch 
é : 
ivmelernen ok Cyne" 
public class SimpleGui2 implements ActionListener one ws inte a ke 
private JButton button; nexionlaseen Po events only 
‘pe urwor = \ementer® 
public static void main(String[] args) { Troan” il 
SimpleGui2 gui = new SimpleGui2(); K , \ eaain GUI elass 
onoanwat NOTE: You, wend ice this thie i ust. te 
eke ingageruant “Well ‘see better ways 
simplest way to 9€ ssid h this chapter. 
public void go() { seeatns ActionListeners as we 9° throug) 
JFrame frame = new JFrame(); 


button = new JButton("click me"); " ig 
: he OVS. evs: 
wnterest wirthh 7 \ sk ox listen om 3 class 


r \ 
~ Renister, Yenad me tI an aojeee eo" 
@ — button. addActionListener (this) ;<— the aie pass Mu Listen€ \ 
‘ at seaplement® eben 
y 
frame.getContentPane().add(button) ; 
frame.setDefaultCloseOperation (JFrame.EXIT ON CLOSE) ; < kcbene ante kace § 
frame.setSize(300, 300); lement khe Aetion A. This is the 
frame.setVisible (true) ; In capes ormed() mecno od! 
} Fee everrt— handling MEL" 


gttual event— 


@ 


public void actionPerformed (ActionEvent event) { 
button.setText ("I've been clicked!") ; 


} The button calls thi 
his method to | 
} h et you k 
stret hi pm belae  gt 
) e : 
happened is adh a Ne it here. Knowing the event 


or us. 
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Listeners, Sources, and Events 


For most of your stellar Java career, you will not be the source of 
events. 


(No matter how much you fancy yourself the center of your social 
universe.) 


Get used to it. Your job is to be a good listener. 


(Which, if you do it sincerely, can improve your social life.) 


As a listener, my job is to 
implement the interface, 

register with the button, and 
provide the event-handling. 


Listener GETS the 
event 


Hey, what about me? I'ma player too, you 
know! As an event object, I'm the argument 
to the event call-back method (from the 
interface), and my job is to carry data 
about the event back to the listener. 
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As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
call the listener's event-handling 
method (when the user clicks me). 


Source SENDS 
the event 


Event object 
HOLDS DATA 
about the event 


&, ent do” 
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event handling 


there are no 


Dumb Questions 


Q: 


A: You CAN. We just said that most of the time you'll 
be the receiver and not the originator of the event 

(at least in the early days of your brilliant Java career). 
Most of the events you might care about are “fired” by 
classes in the Java API, and all you have to do is be a 
listener for them. You might, however, design a program 
where you need a custom event, say, StockMarketEvent 
thrown when your stock market watcher app finds 
something it deems important. In that case, you'd make 
the StockWatcher object be an event source, and you'd 
do the same things a button (or any other source) 
does—make a listener interface for your custom event, 
provide a registration method (addStockListener()), and 
when somebody calls it, add the caller (a listener) to 

the list of listeners. Then, when a stock event happens, 
instantiate a StockEvent object (another class you'll write) 
and send it to the listeners in your list by calling their 
stockChanged(StockEvent ev) method. And don't forget 
that for every event type there must be a matching listener 
interface (so you'll create a StockListener interface with a 
stockChanged() method). 


Why can’t I be a source of events? 


G harpen our pencil 
~ y 


generated by more than one widget. 


Widgets 


check box 


text field 
scrolling list 
button 
dialog box 
radio button 


menu item 
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Each of these widgets (user interface objects) is the 
source of one or more events. Match the widgets with 
the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 


Event methods 


windowClosing() 
actionPerformed() 
itemStateChanged() 
mousePressed() 
keyTyped() 
mouseExited() 


focusGained() 


Q: | don’t see the importance of the event object 
that’s passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other info would I need? 


A: A lot of the time, for most designs, you don’t need 
the event object. It's nothing more than a little data carrier, 
to send along more info about the event. But sometimes 
you might need to query the event for specific details 
about the event. For example, if your mousePressed() 
method is called, you know the mouse was pressed. But 
what if you want to know exactly where the mouse was 
pressed? In other words, what if you want to know the 

X and Y screen coordinates for where the mouse was 
pressed? 


Or sometimes you might want to register the same listener 
with multiple objects. An on-screen calculator, for example, 
has 10 numeric keys, and since they all do the same thing, 
you might not want to make a separate listener for every 
single key. Instead, you might register a single listener with 
each of the 10 keys, and when you get an event (because 
your event call-back method is called), you can calla 
method on the event object to find out who the real event 
source was. In other words, which key sent this event. 


How do you KNOW if 
an object is an event 
source? 


Look in the API. 


OK. Look for what? 


A method that starts with 
“add,” ends with “Listener,” 
and takes a listener inter- 
face argument. If you see: 


addKeyListener(KeyListener k) 


you know that a class 
with this method is a 
source of KeyEvents. 
There’s a naming pattern. 


—+> Your’ to solve. 
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Getting back to graphics... 


Now that we know a little about how events work (we'll learn more 
later), let’s get back to putting stuff on the screen. We'll spend a few 
minutes playing with some fun ways to get graphic, before returning 
to event handling. 


Three ways to put things on your GUI: 


@ Put widgets on a frame 
Add buttons, menus, radio buttons, etc. 
frame .getContentPane() .add(myButton) ; 


The javax.swing package has more than a dozen 


widget types. 
Number of Head 
. ° First Java books 
@ Draw 2D graphics on a widget piseboals 
Use a graphics object to paint shapes. bought by coffee 


house baristas. 
graphics .fillOval (70,70,100,100) ; 


You can paint a lot more than boxes and circles; 
the Java2D APT is full of fun, sophisticated 


graphics methods. Va 


Si : 
mulation. a 
2 


@ Put a JPEG ona widget i, ail 
You can put your own images on a widget. Bee arin Age 


graphics .drawImage (myPic,10,10,this) ; 
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making a drawing panel 


Make your own drawing widget 


If you want to put your own graphics on the screen, your best bet is to 

make your own paintable widget. You plop that widget on the frame, 

just like a button or any other widget, but when it shows up, it will 

have your images on it. You can even make those images move, in an 

animation, or make the colors on the screen change every time you 

click a button. 

It’s a piece of cake. hy Swing, frame with 3 


custom drawing Pane 
Make a subclass of JPanel and override one 


method, paintComponent(). ec50o 


All of your graphics code goes inside the paintComponent() method. 
Think of the paintComponent() method as the method called by 

the system to say, “Hey widget, time to paint yourself.” If you want 
to draw a circle, the paintComponent() method will have code for 
drawing a circle. When the frame holding your drawing panel is 
displayed, paintComponent() is called and your circle appears. If 

the user iconifies/minimizes the window, the JVM knows the frame 
needs “repair” when it gets de-iconified, so it calls paintComponent() 
again. Anytime the JVM thinks the display needs refreshing, your 
paintComponent() method will be called. 


One more thing, you never call this method yourself! The -"-__—_—__—- 


argument to this method (a Graphics object) is the actual drawing 


canvas that gets slapped onto the veal display. You can’t get this by 
yourself; it must be handed to you by the system. You'll see later, 
however, that you can ask the system to refresh the display (repaint()), 
which ultimately leads to pamtComponent() being called. 


ok bese: 


import javax.swing.*; é poth 


, WN You nee 
import java.awt.*; <—— Make 3 bela of 3 Krame \¥ 


class MyDrawPanel extends JPanel { nyt -_ 
~~ This is the Bi Ingortant varie : . 
ill NEVER call this ° a 


u wil wile 


public void paintComponent(Graphics g) { bhi talls nd and - tye Graphics, 
. ate, f 
g.setColor (Color.orange) ; fre iain vain on now: 
that you ™ 
Imagine that. ‘4’ j nbs 
g.fillRect (20, 50, 100, 100); a it hae feu) eerie ae 
wha shape to i ae wn and her 
} Re. where it goes adhow'be a iaees Lor 
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Fun things to do in paintComponent() 


Let’s look at a few more things you can do in paintComponenti). 
The most fun, though, is when you start experimenting yourself: 
Try playing with the numbers, and check the API for class Graphics r 
(later we'll see that there’s even more you can do besides what’s in the « Weve: ee ELrewtty> 
: oe 
Graphics class). Jove filename “DE and 
i] 


Display a JPEG Pry tris line 2 ext ma8Ehr ack mane 


public void paintComponent(Graphics g) { Pe \ exhes 
% 


Image image = new ImageIcon("catzilla.jpg") .getImage() ; 
—_—_———" 


g.drawImage(image, 3, 4, this) ; 


for where the Pitture’s sop 


Ys “3 Pixels from 
F pixels from the 
umbers are always 


the wi j 
ae ew doet (in this Case your JPane| 


» not the entire £, 


vame. 


Paint a randomly colored circle 
on a black background 


public void paintComponent (Graphics g) { 


g.fillRect(0, 0, this ik ea (), this.getHeight()) ; 
ra) KK The tirst two args define the ( 
e entire gare! drawing starts, i O, pa oY? wpper-leFt corner, relative to the panel, for where 


Fill Une Ov (dhe the top edge.” The oth “start O pixels From the left edge and O pinele 
with \plae} th mi _ e other two args say, Make the wi dth o £ thi tha P a rom 
esau tolor ¢ Pane this wid KO) and make the height as tall as the paeel (thicken as 


Java librari 


int red = random.nextInt (256) ; avi now 
ies : we k 
int green = random.nextInt (256) ; that tak we Can use java.util.Ra row how to use the 


Random random = new Random() ; Earlier, we 
used Math.rand 
: om, but 
int blue = “teat b 


ea ma value oo ag ‘Kandom. It has g next|nt method 


ween O (inélusive) 


ca ss 
Color randomColor = new Color(red, green, blue) ; se O-256, 


g.setColor (randomColor) ; 
g.fillOval(70, 70, 100, 100); ee bis hia make 
} Olor b 
ASSing ; 
ie iglie Pixels from the left, ei, 
rom the top, make it 1OO represent th 
pixels wide, and 100 pixels tall. Rep Values . 
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drawing gradients with Graphics2D 


Behind every good Graphics reference 
is a GraphicsZD object 


The argument to paintComponent() is declared as type Graphics 
(java.awt.Graphics). 


public void paintComponent (Graphics g) { } Methods you can call ona 
—_—————<—S—_ 2 
Graphics reference: 
So the parameter “g” IS-A Graphics object. This means it could be a drawlmage() 
subclass of Graphics (because of polymorphism). And in fact, it zs. drawLine() 
The object referenced by the “g” parameter is drawPolygon 
actually an instance of the Graphics2D class. drawRect() 
Why do you care? Because there are things you can do with a drawOval() 
Graphics2D reference that you can’t do with a Graphics reference. fillRect() 
A Graphics2D object can do more than a Graphics object, and 
it really is a Graphics2D object lurking behind the Graphics fillRoundRect() 
reference. setColor() 


Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the object 


type. If you have a Dog object referenced by an Animal reference To cast the Graphics2D object to 
variable: a Graphics2D reference: 

nate ea new eg (i Graphics2D g2d = (Graphics2D) g; 
You CANNOT say: 

a.bark(); 

Even though you know it’s really a Dog back there. The compiler Methods you can call on 

looks at “a,” sees that it’s of type Animal, and finds that there’s no a Graphics2D reference: 

remote control button for bark() in the Animal class. But you can cea 

still get the object back to the Dog it really zs by saying: fillsDRect() 

Dog d = (Dog) a; draw3DRect() 

d.bark() ; 


rotate() 


So the bottom line with the Graphics object is this: seala() 


If you need to use a method from the Graphics2D class, 


ce ia 


shear() 
you can’t use the paintComponent parameter (“g 


straight from the method. But you can cast it with a new irenstonmn() 
Graphics2D variable: setRenderingHints() 


Graphics2D g2d = (Graphics2D) g; 


(These are not complete method lists; 
check the AP| for more) 
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Because life’s too short to paint the wi 
circle a solid color when there's a 
gradient blend waiting for you ©} 


mw 


vett 
nie 2D oe —_— 
\e’s really a aa ate Graphics 


masqver? ai 
abject 
public void paintComponent(Graphics g) { 


Graphics2D g2d = (Graphics2D : 
a rae 2 Cast it so we can ¢all something that 


Graphies2D has but Graphics doesn’t. 


GradientPaint gradient = new GradientPaint(70, 70, Color.blue, 150, 150, Color.orange) ; 
Th Stargide Starting T, | Endi End ng | 

'S sets the. J Point Nie J Poing — 

g2d.setPaint (gradient) ; Jradient insbeag) ctl 


g2d.fillOval(70, 70, 100, 100); 


The £ ‘ 
the oval wit? 
paintbrush fen 


public void paintComponent (Graphics g) { 
Graphics2D g2d = (Graphics2D) g; 


Random random = new Random() ; This 1s jpst \ike < do! tolors for 
int red = random.nextInt (256) ; 
int green = random.nextInt (256) ; the star i 
int blue = random.nextInt (256) ; cadient- Try . 
Color startColor = new Color(red, green, blue) ; ) 


red = random.nextInt (256) ; 

green = random.nextInt (256) ; 

blue = random.nextInt (256) ; 

Color endColor = new Color(red, green, blue) ; 


GradientPaint gradient = new GradientPaint(70, 70, startColor, 150, 150, endColor) ; 


g2d.setPaint (gradient) ; 
g2d.fillOval(70, 70, 100, 100); 
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-———— EVENTS 


events and graphics 


BULLET POINTS 


GRAPHICS 


To make a GUI, start with a window, usually a JFrame: 
JFrame frame = new JFrame() ; 


You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 
frame.getContentPane () .add (button) ; 


Unlike most other components, the JFrame doesn't let 
you add to it directly, so you must add to the JFrame’s 
content pane. 


To make the window (JFrame) display, you must give it a 
size and tell it to be visible: 

frame .setSize (300,300) ; 
frame.setVisible (true) ; 


To know when the user clicks a button (or takes some 
other action on the user interface) you need to listen for a 
GUI event. 


To listen for an event, you must register your interest with 
an event source. An event source is the thing (button, 
check box, etc.) that “fires” an event based on user 
interaction. 


The listener interface gives the event source a way to call 
you back, because the interface defines the method(s) 
the event source will call when an event happens. 


To register for events with a source, call the source’s 
registration method. Registration methods always take 
the form of add<EventType>Listener. To register for a 
button’s ActionEvents, for example, call: 

button. addActionListener (this) ; 


Implement the listener interface by implementing all 

of the interface’s event-handling methods. Put your 

event-handling code in the listener call-back method. For 

ActionEvents, the method is: 

public void actionPerformed (ActionEvent 
event) { 


button.setText ("you clicked!") ; 
} 


The event object passed into the event-handler method 
carries information about the event, including the source 
of the event. 
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You can draw 2D graphics directly on to a widget. 
You can draw a .gif or .jpeg directly on to a widget. 


To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponent() method. 


The paintComponent() method is called by the GUI 
system. YOU NEVER CALL IT YOURSELF. The argu- 
ment to paintComponent() is a Graphics object that 
gives you a surface to draw on, which will end up on 
the screen. You cannot construct that object yourself. 


Typical methods to call on a Graphics object (the paint- 
Component parameter) are: 

g.setColor (Color.blue) ; 

g.fillRect(20, 50, 100, 120); 


To draw a jpg, construct an Image using: 

Image image = new ImageIcon("catzilla. 
jpg") .getImage() ; 

and draw the image using: 
g.drawImage (image ,3,4,this) ; 


The object referenced by the Graphics parameter 
to paintComponent() is actually an instance of the 
Graphics2D class. The Graphics 2D class has a variety 


of methods including: 
fill3DRect(), draw3DRect(), rotate(), scale(), shear(), 
transform() 


To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphics2D 
object: 

Graphics2D g2d = (Graphics2D) g; 
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We can get an event. 
We can paint graphics. 
But can we paint graphics when we get an event? 


Let’s hook up an event to a change in our drawing panel. We'll make the circle change 
colors each time you click the button. Here’s how the program flows: 


Start the app 


The frame is built with the two widgets 
(your drawing panel and a button). A 
listener is created and registered with 
the button. Then the frame is displayed, 
and it just waits for the user to click. 


Change colors 


—_ The user clicks the button, and the 
button creates an event object and 
calls the listener's event handler. 


3) The event handler calls repaint() on the 
frame. The system calls paintComponent() 
on the drawing panel. 


Voila! A new color is painted because 
paintComponent() runs again, filling the 
circle with a random color. 


Change colors 
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building a GUI frame 


Wait a minute...how 
do you put TWO 
things on a frame? 


GUI layouts: putting more than one 
widget on a frame 


We cover GUI layouts in the next chapter, but we’ll do a quickie 
lesson here to get you going. By default, a frame has five regions 
you can add to. You can add only one thing to each region of a 
frame, but don’t panic! That one thing might be a panel that holds 
three other things including a panel that holds two more things 
and...you get the idea. In fact, we were “cheating” when we added 
a button to the frame using: 


frame .getContentPane () .add (button) ; 


This isn’t real 
sis ve the better (ont ‘oo fran —— ss ae 
mandate ant Aways ne | 
aerere | rich wegen) YO" frame .getContentPane() .add(BorderLayout.CENTER, button) ; 
widget to - i single 39 L wer We 
Whe oe es wedi IE ame 
i ca wl and the widget to add fy rere region. 
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, harpen our pencil 
wry 


the frame. 


Given the pictures on page 477, write the 
code that adds the button and the panel to 


—> Yours to solve. 


The circle changes color each time you 
click the button. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class SimpleGui3 implements ActionListener { 


private JFrame frame; 


public static void main(String[] args) { 
SimpleGui3 gui new SimpleGui3(); 


gui.go(); 


{ 


new JFrame (); 


public void go() 
frame 
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( Change colors | 


e 


of 


COUTH resin 
ke Kame 


frame.setDefaultCloseOperation (JFrame.EXIT ON CLOSE) ; 


JButton button new JButton("Change colors" 
button.addActionListener (this); 


MyDrawPanel drawPanel new MyDrawPanel (); 


frame.getContentPane() .add(BorderLayout.SOUT 


\e 


Add the two widoets 
L— (button and dvaving anel) 


H, button); 


frame.getContentPane() .add(BorderLayout.CENT 
frame.setSize(300, 300); 
frame.setVisible (true); 


public void actionPerformed(ActionEvent event) 
frame.repaint(); 


| seks, tell the frame 
ai £. That means 
Meant Component ‘stalled on every 


erage im the Frame! 


When 


class MyDrawPanel extends JPanel { 


public void paintComponent (Graphics g) { 
// Code to fill the oval with a random color 
// See page 365 for the code 


ER, drawPanel) ; 


ut e two regions the 


rame. 


{ 


he drawin 
9 Panel’s p3; 
method j Paint 
hit Nia Ss Called every Fine ferent 


youarehered> 479 


multiple listeners 


Let’s try it with TWO buttons 


The south button will act as it does now, simply calling repaint on the 
frame. The second button (which we’ll stick in the east region) will change 
the text on a label. (A label is just text on the screen.) 


So now we need FOUR widgets 


a_i 


_ pn" L100) 
east aoe tea be \nere 
west center iw 
Label will 
go here 
Drawing, panel goes 
in the center 
south 
Color—changing, 
button will go here 
eee 


And we need to get 
TWO events 


Uh-oh. 


Is that even possible? How do you 


I’m a label Change Label 


get fwo events when you have only 
one actionPerformed() method? 


This butten changes the text 
on the opposite side. 


Change Circle 


This button cha th 
<a ar Pil 
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How do you get action events for two different buttons 
when each button needs to do something different? 


@ Option One 
Implement two actionPerformed() methods 


class MyGui implements ActionListener { 
// lots of code here and then: 


public void actionPerformed(ActionEvent event) { 
Oe F But this is impossible! 
public void actionPerformed(ActionEvent event) { 

label.setText ("That hurt!") ; 


} 
} 


Flaw: You can’t! You can’t implement the same method twice in a Java class. It won't compile. 
And even if you could, how would the event source know which of the two methods to call? 


Option Two 
Register the same listener with both buttons. 


class MyGui implements ActionListener { 
// declare a bunch of instance variables here 


public void go() { 
// build gui 
colorButton new JButton() ; 
labelButton new JButton() ; R re : 
colorButton.addActionListener (this) ; €~ i.) er the same listener 
labelButtonaddActionListener (this) ;~” with both buttons. 
// more gui code here ... 


} 


public void actionPerformed (ActionEvent event) { 
if (event.getSource() == colorButton) { £ object 
frame.repaint() ; ~~ er the even’ 
} else { re ta out whieh ne 
label.setText ("That hurt!") ; actually Fired its an’ . 
that to detide wh 
} 
} 
Flaw: this does work, but in most cases it’s not very OO. One event handler 
doing many different things means that you have a single method doing many different things. 
If you need to change how one source is handled, you have to mess with everybody's event 


handler. Sometimes it is a good solution, but usually it hurts maintainability and extensibility. 
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How do you get action events for two different buttons 
when each button needs to do something different? 


Option Three 
Create two separate ActionListener classes 


class MyGui { 
private JFrame frame; 
private JLabel label; 


void gui() { 
// code to instantiate the two listeners and register one 
// with the color button and the other with the label button 
} 
} 


class ColorButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
frame.repaint() ; 
} aS Won't work! This class doesn t have a veferente to 
} the ‘frame’ variable of the My4ui class. 


class LabelButtonListener implements ActionListener { 
public void actionPerformed (ActionEvent event) { 
label.setText("That hurt!") ; 
} 


Problem! This elass has no reference to the variable “label.” 


Flaw: these classes won’t have access to the variables they need 
to act on, “frame” and “label.” You could fix it, but you'd have to give each of 
the listener classes a reference to the main GUI class, so that inside the actionPerformed() 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that’s breaking encapsulation, so we'd probably need to make getter methods 
for the GUI widgets (getFrame(), getLabel(), etc.). And you'd probably need to adda 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 


There has got to be a better way! 
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Wouldn't it be wonderful if 

you could have two different listener 
classes, but the listener classes could 
access the instance variables of the main 
GUI class, almost as if the listener 
classes belonged to the other class. Then 
you'd have the best of both worlds. Yeah, 
that would be dreamy. But it's just a 
fantasy... 
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inner classes 


Inner class to the rescue! 


You can have one class nested inside another. It’s easy. Just 
make sure that the definition for the inner class is iszde the 
curly braces of the outer class. 


Simple inner class: 


An inner class can 
use all the methods 
and variables of the 
outer class, even the 
private ones. 


class MyOuterClass 


class MyInnerClass { 
void go() { 


The inner class gets 
to use those variables 


and methods just 
as if the methods 
An inner class gets a special pass to use the outer class’s stuff: Even the private and var iables were 
stuff’ And the inner class can use those private variables and methods of the declared within the 
outer class as if the variables and members were defined in the inner class. : la 
That’s what’s so handy about inner classes—they have most of the benefits INNer CLASS. 


of a normal class, but with special access rights. 


Inner class using an outer class variable 


class MyOuterClass { 
private int x; 


class MyInnerClass { 


void go() { Use ‘x’ as if it were a variable 


a= 42s —— of the inner class! 


} // close inner class 


} // close outer class 
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An inner class instance must be tied to 


an outer class instance* pr aalaligg le cea ete 
—_ shares a special 
Remember, when we talk about an inner class accessing something in bond with an 


the outer class, we’re really talking about an zstance of the inner class 
accessing something in an istance of the outer class. But which instance? 


outer object. & 


Can any arbitrary instance of the inner class access the methods and 


variables of any instance of the outer class? No! 


An inner olyect must be tied to a specific outer object on 


the heap. Make an instance of 


the outer class 
————— 


Ww 
Uy Outer gow” 


Make an instance of 
the inner class, by 
using the instance 
of the outer class. 


Ww 
Ae) 
7 


The outer and inner objects 
are now intimately linked. 


. the heap 
two ob ects on ier fF 
an speti3 ond. T he tee 
pee se the outers varia 

can uv ¥ 
(and vice vers” inne* 


*There’s an exception to this, for a very special case—an inner class defined within a static 
method. But we’re not going there, and you might go your entire Java life without ever 
encountering one of these. 
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inner class instances 


How to make an instance of an inner class 


If you instantiate an inner class from code within an outer class, the instance of 
the outer class is the one that the inner object will “bond” with. For example, if 
code within a method instantiates the inner class, the inner object will bond to the 
instance whose method is running. 


Code in an outer class can instantiate one of its own inner classes, in exactly the 
same way it instantiates any other class... new MyInner (). 


class MyOuter { pas a private int 


The outer een # 
private int x; <— instance Var" 


4 ~ Make an instang, 


MyInner inner = new MyInner() ; - 
ner Class. 


e of the 


public void doStuff() { 


inner.go() ; Call a method on the 


} inner élass- 


class MyInner { 


void go() { | . 
RS A2) The method in the inner Class uses U co. 
} = outer Class instance variable -%, as if “x 

} // close inner class belonged to the inner Class. 


} // close outer class 


Sidebar 


You can instantiate an inner instance from code running outside the outer class, but you 
have to use a special syntax. Chances are you'll go through your entire Java life and never MyInner 
need to make an inner class from outside, but just in case you're interested... 


class Foo { 
public static void main (String[] args) { 
MyOuter outerObj = new MyOuter() ; 


MyOuter.MyInner innerObj = outerObj.new MyInner() ; 
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Now we can get the two-button 
code working 
public class TwoButtons { €— 


private JFrame frame; 
private JLabel label; 


Muth better: the wat Gul 
class doesn + implemen 
ActionListener now: 


public static void main(String[] args) { I'm a label 


TwoButtons gui = 
gui.go(); 


new TwoButtons () ; 


public void go() { 
frame = new JFrame() ; 
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Change Circle 


Change Label 


frame .setDefaultCloseOperation (JFrame .EXIT_ON CLOSE) ; 


JButton labelButton = new JButton("Change Label") ; 
labelButton.addActionListener (new LabelListener () ) ; 


JButton colorButton = 
colorButton.addActionListener (new ColorListener () ) ; 


new JButton("Change Circle") ; wa Lhe approrr 


fis) te the 


ano ( 
Instead of Passing A sbion 


regis 


) * er 
button s listen ew instante o 


method, pass 2" 


ate listener class. 


class LabelListener implements ActionListener { 


label = new JLabel ("I’m a label"); 
MyDrawPanel drawPanel = new MyDrawPanel () ; 
TwoButtons 
object 
frame.getContentPane() .add(BorderLayout.SOUTH, colorButton) ; 
frame.getContentPane() .add(BorderLayout.CENTER, drawPanel) ; kev 
frame.getContentPane() .add(BorderLayout.EAST, labelButton) ; ov. 


CJ 


frame.getContentPane() .add(BorderLayout.WEST, label) ; 

LabelListener’ 
frame.setSize(500, 400); object (one) 
frame .setVisible (true) ; ColorListener 

have object 
w Wwe et to J 
ik Lr, RebionListene's 


| 
in a single class: 


public void actionPerformed (ActionEvent event) { 
label.setText("Ouch!") ; 


} B__ Inner elass knows 
about “label.” 


class ColorListener implements ActionListener { 


public void actionPerformed (ActionEvent event) { 
frame.repaint() ; 


In. 
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inner classes 


HeadFirst: What makes inner classes important? 


Inner object: Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can’t implement a method more than 
once in a normal Java class. But using inner classes, each 
inner class can implement the same interface, so you can 
have all these different implementations of the very same 
interface methods. 


HeadFirst: Why would you ever want to implement the 
same method twice? 


Inner object: Let’s revisit GUI event handlers. Think 
about it...1f you want tree buttons to each have a 
different event behavior, then use ¢hree inner classes, all 
implementing ActionListener—which means each class 
gets to implement its own actionPerformed method. 


HeadFirst: So are event handlers the only reason to use 
inner classes? 


Inner object: Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class but 
still want that class to behave as if it were part of another 
class, an inner class is the best—and sometimes only—way 
to do it. 


HeadFirst: I’m still confused here. If you want the inner 
class to behave like it belongs to the outer class, why have 

a separate class in the first place? Why wouldn’t the inner 
class code just be zm the outer class in the first place? 


Inner object: I just gave you one scenario, where you 
need more than one implementation of an interface. But 
even when you're not using interfaces, you might need 
two different classes because those classes represent two 
different things. It’s good OO. 


HeadFirst: Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each be 
modified and used independently, as opposed to stuffing it 
all into one class yada yada yada. But with an inner class, 
youre still just working with one zeal class in the end, right? 
The enclosing class is the only one that’s reusable and 
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Java Exposed 


This week’s interview: 
Instance of an Inner Class 


separate from everybody else. Inner classes aren’t exactly 
reusable. In fact, I’ve heard them called “Reuseless— 
useless over and over again.” 


Inner object: Yes, it’s true that the inner class is not as 
reusable, in fact sometimes not reusable at all, because it’s 
intimately tied to the instance variables and methods of 
the outer class. But it— 


HeadFirst: —which only proves my point! If they’re not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 


Inner object: As I was saying, you need to think about 
IS-A and polymorphism. 


HeadFirst: OK. And I’m thinking about them because... 


Inner object: Because the outer and inner classes 
might need to pass different IS-A tests! Let’s start with the 
polymorphic GUI listener example. What’s the declared 
argument type for the button’s listener registration 
method? In other words, if you go to the API and check, 
what kind of ¢hing (class or interface type) do you have to 
pass to the addActionListener() method? 


HeadFirst: You have to pass a listener. Something that 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What’s your point? 


Inner object: My point is that polymorphically, you have 
a method that takes only one particular type. Something 
that passes the IS-A test for ActionListener. But—and 
here’s the big thing—what if your class needs to be 

an IS-A of something that’s a class type rather than an 
interface? 


HeadFirst: Wouldn’t you have your class just extend the 
class you need to be a part of? Isn’t that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-type thing. 


Inner object: Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Classes 
that aren’t in the same inheritance hierarchy? 


HeadFirst: Oh, well you just...hmmm. I think I’m getting 
it. You can always wmplement more than one interface, but 
you can extend only one class. You can be only one kind of 
IS-A when it comes to class types. 


Inner object: Well done! Yes, you can’t be both a Dog 
and a Button. But if you’re a Dog that needs to some- 
times be a Button (in order to pass yourself to methods 
that take a Button), the Dog class (which extends Animal 
so it can’t extend Button) can have an inner class that acts 
on the Dog’s behalf as a Button, by extending Button, 
and thus wherever a Button is required, the Dog can 
pass his inner Button instead of himself: In other words, 
instead of saying x.takeButton(this), the Dog object calls 
x.takeButton(new MyInnerButton(). 


HeadFirst: Can I get a clear example? 


Inner object: Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
that class is a separate, non-inner, class. And that’s fine, 
because the class doesn’t need special access to the instance 
variables of the main GUI. But what if it did? What if 
we’re doing an animation on that panel, and it’s getting its 
coordinates from the main application (say, based on some- 
thing the user does elsewhere in the GUI). In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 


HeadFirst: Yes, I sec! And the drawing panel isn’t reus- 
able enough to be a separate class anyway, since what it’s 
actually painting is specific to this one GUI application. 


Inner object: Yes! You’ve got it! 


HeadFirst: Good. Then we can move on to the nature of 
the relationship between you and the outer instance. 


Inner object: What is it with you people? Not enough 
sordid gossip in a serious topic like polymorphism? 
HeadFirst: Hey, you have no idea how much the public is 
willing to pay for some good old tabloid dirt. So, someone 
creates you, and you become instantly bonded to the outer 
object, is that right? 

Inner object: Yes, that’s right. 


HeadFirst: What about the outer object? Can it be 
associated with any other inner objects? 


Inner object: So now we have it. This is what you really 
wanted. Yes, yes. My so-called “mate” can have as many 
inner objects as it wants. 
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HeadFirst: Is that like, serial monogamy? Or can it have 
them all at the same time? 


Inner object: All at the same time. There. Satisfied? 


HeadFirst: Well, it does make sense. And let’s not 
forget, it was you extolling the virtues of “multiple 
implementations of the same interface.” So it makes sense 
that if the outer class has three buttons, it would need 
three different inner classes (and thus three different inner 
class objects) to handle the events. 


Inner objects: You got it! 


HeadFirst: One more question. I’ve heard that when 
lambdas came along, you were almost put out of a job? 


Inner objects: Ouch, that really hurts! Okay, full 
disclosure, there are many cases for which a lambda is an 
easier to read, more concise way to do what I do. But inner 
classes have been around for a long time, and you’re sure 
to encounter us in older code. Plus, those pesky lambdas 
aren't better at everything. 


He thinks he's got it made, having 
two inner class objects. But we have 

access to all his private data, so just 

imagine the damage we could do... 
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Can we take another look at that inner 
class code from a few pages back? It 
looks kind of clunky and hard to read. 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation (JFrame.EXIT ON _CLOSI 


eal 
x 


> =< JButton labelButton = new JButton("Change Label"); 
l "—— > labelButton.addActionListener (new LabelListener()) ; 


JButton colorButton = new JButton("Change Circle"); 


Lambdas To the rescue! colorButton.addActionListener (new ColorListener()); 
a 
(again) label = new JLabel ("I’m a label"); 


MyDrawPanel drawPanel = new MyDrawPanel (); 


He’s not wrong! One way to interpret the 


two highlighted lines of code would be: // code to add widgets, here 


frame.setSize(500, 400); 
frame.setVisible (true) ; 


“When the LlabelButton 
ActionListener gets an event, 


setText ("Ouch") ie class LabelListener implements ActionListener { 
public void actionPerformed(ActionEvent event) { 
==> label.setText ("Ouch!") ; 
Not only are those two ideas separated from } 


each other in the code, the inner class takes} 
FIVE lines of code to invoke the set'Text 


method. And of course, everything we’ve class ColorListener implements ActionListener { 
said about the labelButton code is also true public void actionPerformed(ActionEvent event) { 
about the colorButton code. frame.repaint(); 


Remember a few pages back we said that 
in order to implement the ActionListener 
interface you had provide code for its 
actionPerformed method? Hmmm...does 
that ring any bells? 
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ActionListener is a Functional Interface 


Remember that a lambda provides an implementation for a functional 
interface’s one and only abstract method. 


Since ActionListener is a functional interface, you can replace the inner classes we saw on the 
2 
previous page with lambda expressions. 


public void go() { 
frame = new JFrame(); 
frame.setDefaultCloseOperation (JFrame.EXIT ON CLOSE 


~ 


JButton labelButton = new JButton ("Change Label"); 
labelButton.addActionListener (event -> label.setText("Ouch!") ); 


JButton colorButton = new JButton ("Change Circle"); oT 
colorButton.addActionListener (event -> frame.repaint() ); 


These two p; 
his Pleces f 
5. highlighted Code ea 


label = new JLabel ("I’m a label"); he lambdas that 
MyDrawPanel drawPanel = new MyDrawPanel (); replace the inner 
Classes. 


// code to add widgets, here 
frame.setSize(500, 400); 
frame.setVisible (true); 


class LabelListener implements ActionListener All of 4 
publ ®@void actionPerformed (ActionEventml@vent) { uae Not - - rei Class Code is gone! 
label .S@eText ("Ouch!"); e ed! Bye bye. 


a> 


class ColorListenexzsimplementSpActionListener { 


public void.@@tionPerformed (Act@enEvent event) { 
frame@@epaint (); 


Lambdas, clearer and more concise 


Well, maybe not quite yet, but once you get used to reading lambdas, we’re 
pretty sure you'll agree that they make your code clearer. 
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Using an inner class for animation 


We saw why inner classes are handy for event listeners, because you get 
to implement the same event-handling method more than once. But 
now we'll look at how useful an inner class is when used as a subclass of 
something the outer class doesn’t extend. In other words, when the outer 
class and inner class are in different inheritance trees! 


Our goal is to make a simple animation, where the circle moves across 
the screen from the upper left down to the lower right. 


start Finish 


How simple animation works 


@) Paint an object at a particular x and y coordinate. 
g.fillOval (20,50,100,100) ; 
wns 


Ga pixels from the left, 
50 pixels from the top 


@ Repaint the object at a different x and y coordinate. 
—— 
g.fillOval (25,55,100,100) ; 
tos pixels from the left, 55 
pixels from the top 


(the object moved a little 
down and to the right) 


@ Repeat the previous step with changing x and y values 
for as long as the animation is supposed to continue. 
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Dumb Questions 


: Why are we learning 
about animation here? | doubt 
if I’m going to be making 
games. 


A: You might not be making 
games, but you might be 
creating simulations where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 

a graphic to show how much 
memory a program is using 

or to show you how much 

traffic is coming through 

your load-balancing server. 
Anything that needs to take a 
set of continuously changing 
numbers and translate them into 
something useful for getting 
information out of the numbers. 


Doesn't that all sound business- 
like? That's just the “official 
justification,” of course. The real 
reason we're covering it here is 
just because it’s a simple way 
to demonstrate another use of 
inner classes. (And because we 
just like animation.) 
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What we really want is something like... 


Lem invokes the 


class MyDrawPanel extends JPanel { | The sys 
Remember method; YOu don 
public void paintComponent(Graphics g) { paintComponen 
g.setColor (Color.orange) ; have 
g.fillOval(x, y, 100, 100); 
} £0 is 
. onen 
i; e paint! omyon’ ska 
Bath ois oval gets Painted 
different location 


Ge Sharpen your pencil 
ere yer P 


But where do we get the new x and y 
coordinates? 


—— > Answers on page 494. 


And who calls repaint()? 
See if you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right. Our answer is on the next page, so don’t turn 
this page until you're done! 

Big Huge Hint: make the drawing panel an inner class. 

Another Hint: don’t put any kind of repeat loop in the paintComponent() method. 

Write your ideas (or the code) here: 
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animation using an inner class 


The complete simple animation code 


import javax.swing.*; 
import java.awt.*; 
import java.util.concurrent.TimeUnit; 


jables in 
public class SimpleAnimation { Make two instance vairia tne * 4 
private int xPos = 70; E— the main GIA class: tO" . 
private int yPos = 70; Les o& the Cir 


Y coordina 


public static void main(String[] args) { 
SimpleAnimation gui = new SimpleAnimation () ; 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame() ; 
frame. setDefaultCloseOperation (JFrame.EXIT_ON_ CLOSE) ; 


MyDrawPanel drawPanel = new MyDrawPanel () ; 
frame .getContentPane() .add(drawPanel) ; tale new here. Make 


frame.setSize(300, 300); and put them in the ig widgets 
frame.setVisible (true) ; 


This is where pears i= 0; i < 130; itt) { Repeat this 130 Limes 
are xPos++; intrement th 
etion 1s. — n € x and 
the a yPos+t+; coordinates y) ko oe sink itself (so iia 
Tell the anel to ver the new location’ 
drawPanel.repaint () ; ce tan see the civtle in 
try { 
TimeUnit .MILLISECONDS.sleep (50) ; P 
} catch (Exception e) { mw avec between repaints (otherwise it. will 
e.printStackTrace () ; so quickly you won't SEE it move). Don’t oa 
} perry You weren't supposed to alr 
: eady k 
} this. We'll look at this in Chapter 17. Y know 
} 
class MyDrawPanel extends JPanel { 
public void paintComponent(Graphics g) { 
Ss on g.setColor (Color.green) ; 
Now des g.filloval(xPos, yPos, 40, 40); 
: ner Use the Lo ti 
we } toecdnde. ray updated x and 
} o the outer Class. Y 
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Did it work? 

You might not have got the smooth animation that you 
expected. 

What did we do wrong? 

There’s one little flaw in the paintComponent() method. 


We need to erase what was already 
there! Or we might get trails. 


eo°o0 


To fix it, all we have to do is fill in the entire panel with the 
background color, before painting the circle each time. The 
code below adds two lines at the start of the method: one to 
set the color to white (the background color of the drawing 
panel) and the other to fill the entire panel rectangle with that 
color. In English, the code below says, “Fill a rectangle start- 
ing at x and y of 0 (0 pixels from the left and 0 pixels from the 
top) and make it as wide and as high as the panel is currently. 


Z 


public void paintComponent(Graphics g) { 
g.setColor (Color.white) ; 
g.fillRect(0, 0, this.getWidth(), this.getHeight() ); 


g.setColor (Color.green) ; 
g.fillOval(x, y, 40, 40); getWidth() and getHeight() 
} methods inherited From JPanel, 


« 
a2) 
AN y 


Ze Sharpen your pencil loptional, just for Fun) 
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Uh-oh. It didn’t 


move...it. Smeared. 


—» Your’ to solve. 


What changes would you make to the x and y coordinates to produce the animations below? 


(Assume the first example moves in 3-pixel increments. 


) 
1 x_+3 1 x 
yY +3 Y 


start finish start finish 


2 Xe 2 xX 
— —— 


start finish start finish 


3 » 3 x 
YY YY 


start finish start finish 
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Code Kitchen 


o * 


* Code Kitchen 


¥ 


cd sfg SS Ky 


Zi vA 


beat one beat two beat three beat four ... 


Let’s make a music video. We'll use Java-generated random 
graphics that keep time with the music beats. 


Along the way we'll register (and listen for) a new kind of 
non-GUI event, triggered by the music itself. 


Remember, this part is all optional. But we think it’s good for you. 
And you'll like it. And you tan use it to impress people. 


(OK, sure, it might work only on people who are really easy to impress, 
but still...) 
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Listening for a non-GUl event 


OK, maybe not a music video, but we wll make 

a program that draws random graphics on the 

screen with the beat of the music. In a nutshell, the 
program listens for the beat of the music and draws a 
random graphic rectangle with each beat. 


That brings up some new issues for us. So far, we’ve 
listened for only GUI events, but now we need to 
listen for a particular kind of MIDI event. Turns out, 
listening for a non-GUI event 1s just like listening 

for GUI events: you implement a listener interface, 
register the listener with an event source, and then sit 
back and wait for the event source to call your event- 
handler method (the method defined in the listener 
interface). 


The simplest way to listen for the beat of the music 
would be to register and listen for the actual MIDI 
events so that whenever the sequencer gets the event, 
our code will get it too and can draw the graphic. 
But...there’s a problem. A bug, actually, that won’t let 
us listen for the MIDI events we’re making (the ones 


for NOTE ON). 


So we have to do a little workaround. There is 
another type of MIDI event we can listen for, 

called a ControllerEvent. Our solution is to register 
for ControllerEvents and then make sure that 

for every NOTE ON event, there’s a matching 
ControllerEvent fired at the same “beat.” How do we 
make sure the ControllerEvent is fired at the same 
time? We add it to the track just like the other events! 
In other words, our music sequence goes like this: 


BEAT 1 - NOTE ON, CONTROLLER EVENT 
BEAT 2 - NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4 - NOTE OFF 

and so on. 


Before we dive into the full program, though, 

let’s make it a little easier to make and add MIDI 
messages/events since in ¢his program, we’re gonna 
make a lot of them. 
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What the music art program 
needs to do: 


@ Make a series of MIDI messages/ 
events to play random notes ona piano 
(or whatever instrument you choose). 


@® Register a listener for the events. 
@) Start the sequencer playing. 


@) Each time the listener's event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 


We’ll build it in three iterations: 


@ Version One: Code that simplifies mak- 
ing and adding MIDI events, since we'll 
be making a lot of them. 


@ Version Two: Register and listen for 
the events, but without graphics. 
Prints a message at the command line 
with each beat. 


® Version Three: The real deal. Adds 
graphics to version two. 
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utility method for events 


An easier way to make 
messages/events 


Right now, making and adding messages and 

events to a track is tedious. For each message, we 
have to make the message instance (in this case, 
ShortMessage), call setMessage(), make a MidiEvent 
for the message, and add the event to the track. In 
the previous chapter’s code, we went through each 
step for every message. That means eight lines of 
code just to make a note play and then stop playing! 
Four lines to add a NOTE ON event, and four lines 
to add a NOTE OFF event. 


ShortMessage msgl = new ShortMessage() ; 
msgl.setMessage (NOTE ON, 1, 44, 100); 
MidiEvent noteOn = new MidiEvent(msgl, 1); 
track .add(noteOn) ; 


ShortMessage msg2 = new ShortMessage() ; 
msg2.setMessage (NOTE OFF, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent(msg2, 16) ; 
track .add(noteOff) ; 


Let’s build a static utility method that 
makes a message and returns a MidiEvent 


Things that have to happen for 
each event: 


@ Make a message instance 


ShortMessage msg = new ShortMessage () ; 


@ Call setMessage() with the instructions 


msg.setMessage (NOTE _ON, 1, instrument, 0); 


@® Make a MidiEvent instance for the message 
MidiEvent noteOn = new MidiEvent(msg, 1); 


@) Add the event to the track 


track .add(noteOn) ; 


The event ‘iol’ 
aaghs ent ‘tick’ £. 
The four a pula this message 
Lor dhe me should happen 


public static MidiEvent makeEvent (int command, int channel, int one, int two, int tick) 


MidiEvent event = null; 


try { 


Whoo! A method with five parameters. 


ShortMessage msg = new ShortMessage() ; 


msg.setMessage (command, channel, one, two); 


event = new MidiEvent(msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace() ; 
} 


return event; 
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Make th 
the nel message and 


d Parameter. event, using 


Return the event (3 MidiEvent all 
loaded up with the message). 
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Version One: using the new static 
makeEventl) method 


There’s no event handling or graphics here, just a sequence of 15 notes 
that go up the scale. The point of this code is simply to learn how to 
use our new makeEvent() method. The code for the next two versions is 
much smaller and simpler thanks to this method. 


import javax.sound.midi.*; <—— Don't forget the imports. 
import static javax.sound.midi.ShortMessage.*; 


public class MiniMusicPlayerl { 
public static void main(String[] args) { 


try { 
Sequencer sequencer = MidiSystem.getSequencer () ; ava cequente™ 
sequencer.open() ; TK make (and oF 


Sequence seq = new Sequence (Sequence.PPQ, 4) ; <~— Make ee aa 
Track track = seq.createTrack () ; L— and a track. 


Make a bunch of events to make the notes keep 


For (int 4 = 5S d-< 612 4 d= 4) G2" SN (from piano note 9 to piano note 41). 


track.add(makeEvent(NOTE_ ON, 1, i, 100, i)); Call our new makeE 
track.add(makeEvent (NOTE_OFF, 1, i, 100, i + 2)); method to make aes 
message 


. and event; then add th 

(the MidiEvent irelursed t as 
sequencer. setSequence (seq) ; wee a oak ” 
sequencer. setTempoInBPM(220) ; } Start it running These are NOTE ON and NOTE 


sequencer.start() ; Pairs. 
} catch (Exception ex) { 


ex.printStackTrace() ; 


} 


public static MidiEvent makeEvent (int cmd, int chnl, int one, int two, int tick) 
MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage () ; 
msg.setMessage(cmd, chnl, one, two); 
event = new MidiEvent(msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace () ; 


} 


return event; 
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controller events 


Version Two: registering and getting ControllerEvents 


import javax.sound.midi.*; 
import static javax.sound.midi.ShortMessage. *; 


public class MiniMusicPlayer2 { 
public static void main(String[] args) { 
MiniMusicPlayer2 mini = new MiniMusicPlayer2 () ; 
mini.go(); 
} 
: se uencer- 
ov events with the sen 4 


F F i f he 
spree ica aes cea veajsbration eects 
try ae int axvay ¥ 
Sequencer sequencer = MidiSystem.getSequencer () ; istener ConbrollerEvents you want: 7 
sequencer .open () ; the lis out one event» 1. 


u— want care 3 
int[] eventsIWant = {127}; 
sequencer .addControllerEventListener (event -> System.out.println("la"), eventsIWant) ; 


we'll print “yg” 


Sequence seq = new Sequence (Sequence.PPQ, 4); 
Track track = seq.createTrack () ; 


t, 
ime we get the even * nbd 
Each Lim smardh KE: We ve a ae ieee 
to the us i bs handle this ont o 
i " 
for (int i= 5; i < 60; i += 4) { expression e 
track.add(makeEvent (NOTE ON, 1, i, 100, i)); Here’s how we pick up the beat—we 


insert our OWN 
track .add(makeEvent (CONTROL CHANGE, 1, 127, 0, i)); (CONTROL CHANCES erent 


or event number sey an sae 


track.add(makeEvent (NOTE OFF, 1, i, 100, i+ 2)); do NOTHING! We put it ee will 
2 St ti to ev cht 
is played. ; 
sequencer .setSequence (seq) ; Purpose ‘s i Mae eat 
sequencer .setTempoInBPM (220) ; hat WE tan listen ie 5 wil Wwe 
sequencer. start () : for NOTE ON/OFF nS gs listen 
} catch (Exception ex) { this event happen at: the CAME re making 
ex.printStackTrace() ; the NOTE_ON. Sake the ihc i 
5 } ia happens, we'll know about. it ail 
R event will fire at the same time. : 


public static MidiEvent makeEvent(int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 


t { e 
ihe aalaa vase msg = new ShortMessage() ; Code that’s different from the 


eae Previous version is highlighted in 
} catch (Exception e) { gray (and we've moved the code 


e.printStackTrace () ; 


} out of the main() method into its 
return event; own g0() m etho d). 


} 
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Version Three: drawing graphics in time with the music 


This final version builds on Version ‘Two by adding the GUI parts. We build a 
frame and add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from Version ‘Two is 
that the notes play randomly as opposed to simply moving up the scale. 


The most important change to the code (besides building a simple GUI) is that we 
make the drawing panel implement the ControllerEventListener rather than the 
program itself. So when the drawing panel (an inner class) gets the event, it knows 
how to take care of itself by drawing the rectangle. 


Complete code for this version 1s on the next page. 


The drawing panel inner class: 


The drawing Pane 


v— 


| is a listener: 


getting gui 


class MyDrawPanel extends JPanel implements ControllerEventListener { 


private boolean msg = false; —— ads ? flag to false, and we'll set it 
rue only when we get an event. 
public void controlChange(ShortMessage event) { han ° 
The event £ listener inte 


msg = true; KX We 4) ollerEven sek 
repai nt Q e ot an Contr . Wressio 
Q; 4 event, So we set the fla to ve not using, a ambda 7 | 
} true and ¢all repaint() 3 aa \ 9 se we want he Pane 


to listen to ControllerEvents 


(from the 
dle method Stee). 


public void paintComponent(Graphics g) { 


if (msg) { We have to use a flag beca 
int r = random.nextInt (250) ; things might tri ger sora iad 2 
int gr = random.nextInt (250) ; we want paint ONLY when th ie 
int b = random.nextInt (250) ; ControllerEvent. ewe 


g.setColor (new Color(r, gr, b)); 


int height = random.nextInt(120) + 10; The rest is tode to generate 

int width = random.nextInt(120) + 10; a random ¢olor and paint a 
Semirandom rectangle. 

random.nextInt(40) + 10; 

random.nextInt(40) + 10; 


int xPos 
int yPos 


g.fillRect(xPos, yPos, width, height) ; 
msg = false; 
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MiniMusicPlayer3 code 


erp your pencil —+ Yours to solve. 
IN 


import javax.sound.midi.*; This is the complete code listing for Version 
import javax.swing.*; Three. It builds directly on Version Two. Try 
import java.awt.*; 


: J ; to annotate it yourself, without looking at the 
import java.util.Random; 


previous pages. 


import static javax.sound.midi.ShortMessage. *; 


public class MiniMusicPlayer3 { 
private MyDrawPanel panel; 
private Random random = new Random() ; 


public static void main(String[] args) { 
MiniMusicPlayer3 mini = new MiniMusicPlayer3() ; 
mini.go(); 


} 


public void setUpGui() { 
JFrame frame = new JFrame("My First Music Video") ; 
panel = new MyDrawPanel () ; 
frame.setContentPane (panel) ; 
frame.setBounds (30, 30, 300, 300); 
frame.setVisible (true) ; 


} 


public void go() { 
setUpGui () ; 


try { 
Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer .open () ; 
sequencer .addControllerEventListener (panel, new int[]{127}); 
Sequence seq = new Sequence (Sequence.PPQ, 4); 
Track track = seq.createTrack () ; 


int note; 

for (int i= 0; i < 60; i += 4) { 
note = random.nextInt(50) + 1; 
track.add(makeEvent (NOTE ON, 1, note, 100, i)); 
track.add(makeEvent (CONTROL CHANGE, 1, 127, 0, i)); 
track.add(makeEvent (NOTE OFF, 1, note, 100, i + 2)); 

} 


sequencer .setSequence (seq) ; 
sequencer.start() ; 

sequencer .setTempoInBPM (120) ; 
catch (Exception ex) { 
ex.printStackTrace () ; 


~ 
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public static MidiEvent makeEvent(int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage() ; 
msg.setMessage (cmd, chnl, one, two) ; 
event = new MidiEvent(msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace () ; 
} 
return event; 


} 


class MyDrawPanel extends JPanel implements ControllerEventListener { 
private boolean msg = false; 


public void controlChange(ShortMessage event) { 
msg = true; 
repaint(); 


} 


public void paintComponent(Graphics g) { 
if (msg) { 
int r = random.nextInt (250) ; 
int gr = random.nextInt (250) ; 
int b = random.nextInt (250) ; 


g.setColor(new Color(r, gr, b)); 


int height = random.nextInt(120) + 10; 
int width = random.nextInt(120) + 10; 


int xPos = random.nextInt(40) + 10; 
int yPos = random.nextInt(40) + 10; 


g.fillRect(xPos, yPos, width, height) ; 
msg = false; 
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exercise: Who Am | 


504 


might show up! 


| got the whole GUI, in my hands. 
Every event type has one of these. 
The listener’s key method. 

This method gives JFrame its size. 


You add code to this method but never call it. 


When the user actually does something, it’s an 


Most of these are event sources. 


| carry data back to the listener. 


An addXxxListener( ) method says an object is an : 


How a listener signs up. 

The method where all the graphics code goes. 
I’m typically bound to an instance. 

The “g” in (Graphics g) is really of this class. 


The method that gets paintComponent( ) rolling. 


The package where most of the Swingers reside. 


chapter 14 


Tonight's attendees: 
Any of the charming personalities from this chapter just 


A bunch of Java hotshots, in full costume, are playing the party game “Who 
am |?” They give you a clue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
happen to say something that could be true for more than one guy, then 
write down all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 


————> Answers on page 507. 
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BE the Compiler 


_ ‘The Java file on this page represents a 
H.. complete source file. Your job is to play 
,. compiler and determine whether this file 
M will compile. If it won’t compile, how 
would you fix it, and if it does 
compile, what would it do? 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


class InnerButton { 
private JButton button; 


public static void main(String[] args) 
InnerButton gui = new InnerButton(); 
gui.go(); 


public void go() { 
JFrame frame = new JFrame(); 
frame.setDefaultCloseOperation ( 
JFrame .EXIT ON CLOSE); 


button = new JButton ("A"); 
button.addActionListener () ; 


frame.getContentPane () .add( 
BorderLayout.SOUTH, button); 

frame.setSize(200, 100); 

frame.setVisible (true) ; 


class ButtonListener extends ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (button.getText().equals("A")) { 
button.setText ("B"); 
} else { 
button.setText ("A"); 


——+ Answers on page 507. 


youarehere> 505 


puzzle: Pool Puzzle 


RS Poo] Puzzle 


Your job is to take code snippets from 
the pool and place them into the blank 
lines in the code. You may use the 
same snippet more than once, 
and you won't need to use all the 
snippets. Your goal is to make a 
class that will compile and run 
and produce the output listed. 


Output 


The Amazing, Shrinking, Blue Rectangle. 
This program will produce a blue rectangle 
that will shrink and shrink and disappear into 
a field of white. 


Note: Each snippet 
from the pool can be 
used more than once! 


g.fillRect(x,y,x-500,y-250) 
g.fillRect(x,y,500-x*2,250-y*2) 
g fillRect(500-x*2,250-y*2,x,y) 
Xt++ — g.fillRect(0,0,250,500) 
yt+  g.fillRect(0,0,500,250) 
“g.setColor(blue) g 
g.setColor(white) draw 
( 
( 


i++ 


drawP.paint() 
draw.repaint() 
drawP.repaint() 


g.setColor(Color.blue) frame 
g.setColor(Color.white) panel 
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i++, y++ 
i++, y++, Xt++ 
Animate frame = new Animate() 


MyDrawP drawP = new MyDrawP() 
ContentPane drawP = new ContentPane() 


import javax.swing.*; 

import java.awt.*; 

import java.util.concurrent.TimeUnit; 

public class Animate { 

1; 

1; 

public static void main(String[] 
Animate gui = Q; 
gui.go(); 


int x = 
int y = 
args) { 
new Animate 


} 

public void go() { 
JFrame = new JFrame(); 

frame.setDefaultCloseOperation ( 


JFrame.EXIT ON CLOSE) ; 


-getContentPane() .add(drawP) ; 
.setVisible (true) ; 
(int i=0; i<124; ) 


for 


try { 
TimeUnit .MILLISECONDS.sleep (50) ; 
} catch (Exception ex) { } 
} 
} 
class MyDrawP extends JPanel { 


public void paintComponent (Graphics 


drawP.setSize(500,270) 
frame.setSize(500,270) 
panel.setSize(500,270) 


———> Answers on page 508. 


, 


Exercise Solutions 


Who Am ky (from page 504) 


| got the whole GUI, in my hands. 


Every event type has one of these. 


The listener’s key method. 


This method gives JFrame its size. 


You add code to this method but 
never call it. 


When the user actually does 
something, it’s an ‘ 


Most of these are event sources. 
| carry data back to the listener. 


An addXxxListener( ) method 
says anobjectisan___. 


How a listener signs up. 


The method where all the 
graphics code goes. 


I’m typically bound to an instance. 


The “g” in (Graphics g) is 
really of this class. 


The method that gets 
paintComponent( ) rolling. 


The package where most of the 
Swingers reside. 


JFrame 
listener interface 
actionPerformed( ) 


setSize( ) 


paintComponent( ) 


event 
swing components 


event object 


event source 


addXxxListener( ) 


paintComponent( ) 


inner class 


Graphics2D 


repaint( ) 


javax.swing 
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BE the Compiler (from page 505) 


Once this code 
is fixed, it will 

create a GUI with 
a button that 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 
toggles between 
A and B when you 
click it. 


class InnerButton { 
private JButton button; 


public static void main(String[] args) { 
InnerButton gui = new InnerButton(); 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame(); 
frame.setDefaultCloseOperation ( 
JFrame.EXIT ON CLOSE) ; 


The addActionListener( ) 
method takes a class that 


implements the ActionLis- 
tener interface. 


button = new JButton("A"); 
button.addActionListener (new ButtonListener()) ; 


frame.getContentPane() .add ( 
BorderLayout.SOUTH, button); 

frame.setSize(200, 100); 

frame.setVisible(true); 


} 


class ButtonListener implements ActionListener { 
public void actionPerformed(ActionEvent e) { 
if (button.getText().equals("A")) { 
button.setText ("B"); 
} else { 
button.setText ("A"); 
} 
} ActionListener is an 
} interface; interfaces 
} are implemented, not 
extended. 
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puzzle answers 


| 
(“au Pos] Puzzle (from page 506) 


import javax.swing.*; 
import java.awt.*; 


import java.util.concurrent.TimeUnit; 


public class Animate { 
int x =1; 
int y = 1; 
public static void main(String[] args) { 
Animate gui = new Animate (); 
gui.go(); 
} 


public void go() { 
The Amazing, Shrinking, Blue JFrame frame = new JFrame (); 


Rectangle. 7 
scaamach sc frame.setDefaultCloseOperation ( 


JFrame .EXIT_ON CLOSE) ; 
MyDrawP drawP = new MyDrawP(); 
frame. getContentPane().add(drawP) ; 
frame.setSize(500, 270); 
frame.setVisible (true); 
for (int i = 0; i < 124; it++,y++,x++ ) { 
X++; 
drawP.repaint() ; 


Cay 
TimeUnit.MILLISECONDS.sleep (50) ; 


} catch(Exception ex) { } 


} 
class MyDrawP extends JPanel { 
public void paintComponent (Graphics g) { 
g-setColor(Color.white); 
g.fillRect(0, 0, 500, 250); 
g-setColor(Color.blue); 
g.fillRect(x, y, 500-x*2, 250-y*2); 
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15 using swing 


Work on Your Swing 


Why won't the 
ball go where I want it to 
go (like, smack in Suzy Smith's 
face)? I've gotta learn to 


control it. 


Swing is easy. Unless you actually care where things end up on the screen. Swing code 
looks easy, but then you compile it, run it, look at it, and think, “hey, that’s not supposed to 

go there.” The thing that makes it easy to code is the thing that makes it hard to control—the 
Layout Manager. Layout Manager objects control the size and location of the widgets in a 
Java GUI. They do a ton of work on your behalf, but you won't always like the results. You want 
two buttons to be the same size, but they aren't. You want the text field to be three inches 
long, but it’s nine. Or one. And under the label instead of next to it. But with a little work, you 
can get layout managers to submit to your will. Learning a little Swing will give you a head start 
for most GUI programming you'll ever do. Wanna write an Android app? Working through this 


chapter will give you a head start. 
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components and containers 


Swing components 


Component is the more correct term for what we’ve been calling a widget. 
The things you put ina GUI. The things a user sees and interacts with. Text fields, 


buttons, scrollable lists, radio buttons, etc., are all components. In fact, they all A widget 18 technically 


extend javax.swing.JComponent. 5 . C nt 
WW) 0 Pone ‘ 
Components can be nested ee ; 
Almost everything you 


In Swing, virtually a// components are capable of holding other components. - e 
In other words, you can stick just about anything into anything else. But most of can stick ma GUI 
the time, you'll add user interactwe components such as buttons and lists into extends from 


background components (often called containers) such as frames and panels. . : 

Although it’s possible to put, say, a panel inside a button, that’s pretty weird and javax.swing. J Component. 
won't win you any usability awards. 

With the exception of JFrame, though, the distinction between interactive 

components and background components 1s artificial. A JPanel, for example, 

is usually used as a background for grouping other components, but even a 

JPanel can be interactive. Just as with other components, you can register for 

the JPanel’s events including mouse clicks and keystrokes. 


Four steps to making a GUI (review) 
@ Make a window (a JFrame) 


JFrame frame = new JFrame() ; 


@ Make a component (button, text field, etc.) 
JButton button = new JButton ("click me") ; 


@ Add the component to the frame 
frame .getContentPane() .add(BorderLayout.EAST, button) ; 


@ Display it (give it a size and make it visible) 
frame.setSize (300,300) ; 
frame.setVisible (true) ; 


Put interactive components: Into background components: 
sn 
me JFrame JPanel 
~) choose me Checkbox 
this is a text field JTextField 
LL — 
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Layout Managers 


A layout manager is a Java object associated with 

a particular component, almost always a background 
component. The layout manager controls the 
components contained wthin the component the 
layout manager is associated with. In other words, if 
a frame holds a panel, and the panel holds a button, 
the panel’s layout manager controls the size and 
placement of the button, while the frame’s layout 
manager controls the size and placement of the 
panel. The button, on the other hand, doesn’t 
need a layout manager because the button 

isn’t holding other components. 


If a panel holds five things, the size and 
location of the five things in the panel are all 
controlled by the panel’s layout manager. If 
those five things, in turn, hold other things (e.g., 
if any of those five things are panels or other 
containers that hold other things), then those 
other things are placed according to the layout 
manager of the thing holding them. 


When we say hold, we really mean add as in, a 
panel holds a button because the button was added to 
the panel using something like: 


myPanel.add (button) ; 


Layout managers come in several flavors, and each 
background component can have its own layout 
manager. Layout managers have their own policies 
to follow when building a layout. For example, one 
layout manager might insist that all components 

in a panel must be the same size, arranged in a 
grid, while another layout manager might let each 
component choose its own size but stack them 
vertically. Here’s an example of nested layouts: 


JPanel 
JPanel 


panelA = 


panelB 
panelB. 
panelB 
panelB. 


panelA.add(pane1B) ; 


new JPanel () ; 
new JPanel () ; 
add(new JButton("button 1")) ; 
.add(new JButton ("button 2")) ; 
add(new JButton ("button 3")) ; 


using swing 


As a layout manager, 
I'm in charge of the size 

and placement of your components. 

In this GUT, I'm the one who decided 

how big these buttons should be and 

where they are relative to each 


other and the frame. 


Panel A’s la 
Yout mana 
9nd ea hela the size and Jer 
Panel Bs IT and place™ Placement of Pane! B. 
iv e 
Lo 
ton 


Panel B 


Panel A 


Panel A’s layout manager has NO 

say about the three bwttons ili 
tontrol is only one level—Panel A's Eye! 

manager Controls only the things added direct 

to Panel A, and does not tontrol an thin ’ 

nested within those added ambos: . 
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layout managers 


How does the layout manager decide? 


Different layout managers have different policies for arranging 
components (like, arrange in a grid, make them all the same size, stack 
them vertically, etc.), but the components being laid out do get at least 
some small say in the matter. In general, the process of laying out a 
background component looks something like this: 


A layout scenario 


@) Make a panel and add three buttons to it. 


@ The panel's layout manager asks each button how big 
that button prefers to be. 


@) The panel's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the buttons’ 
preferences. 


@ Add the panel to a frame. 


©) The frame's layout manager asks the panel how big the panel 
prefers to be. 


© The frame's layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panel's 
preferences. 


Different layout managers have different policies 


Some layout managers respect the size the component wants to be. 

If the button wants to be 30 pixels by 50 pixels, that’s what the layout 
manager allocates for that button. Other layout managers respect 

only part of the component’s preferred size. If the button wants to be 
30 pixels by 50 pixels, it'll be 30 pixels by however wide the button’s 
background panel is. Still other layout managers respect the preference 
of only the dargest of the components being laid out, and the rest of the 
components in that panel are all made that same size. In some cases, the 
work of the layout manager can get very complex, but most of the time 
you can figure out what the layout manager will probably do, once you 
get to know that layout manager’s policies. 
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Let's see here...the 
first button wants to be 
30 pixels wide, the text field needs 
50, the frame is 200 pixels wide, and 
I'm supposed to arrange everything 
vertically... 


Layo mandyer 


using swing 


The Big Three layout managers: 
border, flow, and box 


BorderLayout 


A BorderLayout manager divides a background 


component into five regions. You can add only one ‘ 
one tomponen 


component per region to a background controlled 
0 


by a BorderLayout manager. Components laid out er 
by this manager usually don't get to have their 
preferred size. BorderLayout is the default layout 


manager for a frame! 


FlowLayout 


A FlowLayout manager acts kind of like a word 


processor, except with components instead of { ) Components ad 


d 
words. Each component is the size it wants to be, Om t=_ right, ed left 


pe wrapping to a 
and they're laid out left to right in the order that ai new line when needed 


they're added, with “word wrap" turned on. So 


when a component won't fit horizontally, it drops 
to the next “line” in the layout. FlowLayout is the 
default layout manager for a panel! 


BoxLayout 


. . . Ae 
A BoxLayout manager is like FlowLayout in that 
each component gets to have its own size, and Cf 
the components are placed in the order in which ial Components added of 
they're added. But, unlike FlowLayout, a BoxLayout ko bottom one iv salt 
manager can stack the components vertically (or Ou af it’s set vp vere i 
arrange them horizontally, but usually we're just a) 
concerned with vertically). It's like a FlowLayout = 
but instead of having automatic “component ——————— 
wrapping,” you can insert a sort of “component 
return key" and force the components to start a 
=~ 
new line. 
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border layout 


————, BorderLayout cares 
about five regions: 
east, west, north, 
_\_—_] south, and center 


Let’s add a button to the east region: 


; . ackase- 
import javax.swing.*; Bor derLayout is in the javaawt i 9 


import java.awt.*; €— 


public class Buttonl { 
public static void main(String[] args) { 
Buttonl gui = new Buttonl1(); 
gui.go(); 
} 


public void go() { cyetify the enon 
JFrame frame = new JFrame() ; 
JButton button = new JButton("click me") ; 
frame .getContentPane() .add(BorderLayout.EAST, button) ; 
frame.setSize(200, 200); 
frame.setVisible (true) ; 


i» 


How did the BorderLayout manager come up with 
this size for the button? 


What are the factors the layout manager has to 


: click me 
consider? 


Why isn't it wider or taller? 
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Watch what happens when we give 
the button more characters... 


public void go() { 

JFrame frame new JFrame(); 

JButton button new JButton("click like 
frame.getContentPane().add(BorderLayout. 
frame.setSize(200, 200); 


frame.setVisible (true); 


First, I ask 
the button for its 
preferred size. 


Since 

it's in the east region 
of a border layout, I'll respect 
its preferred width. But I don't care 
how tall it wants to be; it's gonna be 
as tall as the frame, because that's 


my policy. 


click like you mean it 


using swing 


at 
We crane nh} ke tert 
on the putter 


you mean it"); 
FAST, button); 


I have a lot of words 
now, so I'd prefer to be 
60 pixels wide and 25 
pixels tall. 


) 
S) 


mK 


Sutton 4 


Next time 
I'm goin’ with flow 


layout. Then I get 
EVERYTHING I want. 
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border layout 


Let’s try a button in the NORTH region 


public void go() { 


JFrame frame = new JFrame(); 
JButton button = new JButton("There is no spoon..."); 
frame.getContentPane().add(BorderLayout.NORTH, button) ; 


frame.setSize(200, 200); 
frame.setVisible (true) ; 


. 
rs . all gs vt 
as Bi ne 
eee The putter ey on wide 3 
Be wwanks te ber O° 
dhe Leame- 


Now let’s make the button ask to be taller 


How do we do that? The button is already as wide 
as it can ever be—as wide as the frame. But we 
can try to make it taller by giving it a bigger font. 


public void go() { A\ forte tne 
JFrame frame = new JFrame(); p binge’ Cont ae ore spate 
JButton button = new JButton("Click This!") ; Came ko allots er nt: 
a ‘ ns se) 


Font bigFont = new Font("serif", Font.BOLD, 28) ; Sor khe ute 
button. setFont (bigFont) ; 
frame.getContentPane().add(BorderLayout.NORTH, button); 


frame.setSize(200, 200); 
frame.setVisible (true); 


} ec5o er 
eS Ls sath stays the same; 
Click This! |r nin is taller. The vorth 
the Dut teed to accommodare 
ferred height: 


region sure 


the buttons new Pre 
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I think I'm getting it...if I'm in east or 
west, I get my preferred width, but the 
height is up to the layout manager. And 

if I'm in north or south, it's just the 
opposite—I get my preferred height, but 
not width. 


Breese” 


The center region gets whatever's left! 
(except in one special case we'll look at later) 


public void go() { 
JFrame frame new JFrame(); 


JButton 
JButton 


east new JButton ("East"); 
west = new JButton("West"); 


EAS! 
WES! 


SOUT 


NORT 


using swing 


But what happens 


in the center region? 


[, east); 
[, west); 
H, north); 
TH, south); 


CENTER, center); 


JButton north = new JButton ("North"); 
JButton south = new JButton ("South"); 
JButton center = new JButton("Center"); 
frame.getContentPane().add(BorderLayout. 
frame.getContentPane().add(BorderLayout. 
frame.getContentPane().add(BorderLayout. 
frame.getContentPane().add(BorderLayout. 
frame.getContentPane().add(BorderLayout. 
frame.setSize(300, 300); 
frame.setVisible (true) ; eee 


VAN 
Components in th Wr 
whatever one Center get TEM You Put somethi 
Space is lef in the nor. ng 
b over, eae: 
ased on the frame dir». “4 goes all 4 outh, it 
300 x 300 ; rie dimensions ed he £ he wa across 
n this Code). Center = A = Be hing 
9 ie @a and west 
9 won't be a 
onents in the east and : * would be t " Mas they 
| + their preferred width aid seth. he north 
er eSions 
: onents in the porth and empty. were 
th get their preferred 
height: —— 
300 pixels 
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flow layout 
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FlowLayout cares 


{__}© | about the flow of the 


Ot =z) | Components: 


(==) left to right, top to bottom, in 
the order they were added. 


Let’s add a panel to the east region: 


A JPanel's layout manager is FlowLayout, by default. When we adda 
panel to a frame, the size and placement of the panel are still under 
the BorderLayout manager's control. But anything inside the panel 
(in other words, components added to the panel by calling panel . 
add (aComponent) ) are under the panel's FlowLayout manager's 
control. We'll start by putting an empty panel in the frame's east 


region, and on the next pages we'll add things to the panel. ; 
The panel doesnt have ey oS 

an it, So tt doesn t ask tor 

width in the east region- 


import javax.swing.*; eee 
import java.awt.*; 
public class Panell { 


public static void main(String[] args) { 
Panell gui = new Panell(); 
gui.go(); 

} 


public void go() { 
JFrame frame = new JFrame() ; Make the Panel Qray so we Can see 
JPanel panel = new JPanel (); Le it is on the — 
panel .setBackground (Color.darkGray) ; 
frame.getContentPane() .add(BorderLayout.EAST, panel) ; 
frame.setSize(200, 200); 
frame.setVisible (true) ; 
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using swing 


Let’s add a button to the panel 


public void go() { 


JFrame frame = new JFrame(); 
JPanel panel = new JPanel(); gnel--- 
panel.setBackground(Color.darkGray) ; nad khe putton to the ? 
JButton button = new JButton("shock me") ; 
panel .add (button) ; 
frame.getContentPane().add(BorderLayout.EAST, panel); 
frame.setSize(200, 200); ; trols 
frame.setVisible (true) ; ..and add the panel to the _— panel's layout manager ss 
e 5 \ayou 
ame S 
| the than ad ee nel 
. : manager oraer 
eee ec5o 
The panel expanded! 
gavel garel ie the button got its 
——>. Preterred size in both 


dimensions, because the panel 
uses tlow layout, and the 


button is ° 
lot. the ee the Panel 


OK...I need to 
know how big the 
panel wants to be... 


TI need 
to know how big the 
button wants to 


Based on my font 
size and the number of 
characters, I want to be 70 

pixels wide and 20 pixels tall. 


I have a button now, so 
my layout manager's gonna 
have to figure out how big 
I need to be... 


“SS ww 
controls > L a controls ? Suppor oe 


She] do” 


The frame's The panel's 
BorderLayout manager FlowLayout manager 
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flow layout 


What happens if we add TWO buttons 
to the panel? 


520 


public void go() { 
JFrame frame = new JFrame(); 
JPanel panel = new JPanel(); 
panel.setBackground(Color.darkGray) ; 


JButton button = new JButton("shock me"); 
JButton buttonTwo = new JButton("bliss"); 


panel .add (button) ; <— 


Add 
panel .add (buttonTwo) ; &— BOTH to the Panel 


frame.getContentPane() .add(BorderLayout.EAST, 


frame.setSize(250, 200); 
frame.setVisible (true); 


what we wanted: 


| Lkons 
We wart ait rt eath 


Piss stacked 
other: 


iad your pencil 
IN —> Your's to solve. 


If the code above were modified to the code below, 
what would the GUI look like? 


JButton button = new JButton("shock me"); 
JButton buttonTwo = new JButton("bliss"); 


JButton buttonThree = new JButton("huh?") ; 


panel.add (button) ; 
panel.add(buttonTwo) ; 
panel.add(buttonThree) ; 
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panel); 


what we got: 


Pishockme J bliss | 


Draw what you 
think the GUI would 
look like if you ran 
the code to the left. 


(Then try it!) 


using swing 


oe 
Cf BoxLayout to the rescue! 
ml It keeps components 
Sm stacked, even if there’s room 
C_y to put them side by side. 


Unlike FlowLayout, BoxLayout can force a 
“new line” to make the components wrap to 
the next line, even if there’s room for them 
to fit horizontally. 


But now you'll have to change the panel's layout manager from the 
default FlowLayout to BoxLayout. 


public void go() { 


JFrame frame = new JFrame(); ra anager to be a new 

JPanel panel = new JPanel(); Charge th \ayou ne j 

panel.setBackground (Color.darkGray) ; nstance of Borla} 

panel.setLayout (new BoxLayout(panel, BoxLayout.Y AXIS)) ; 

JButton button = new JButton("shock me"); \ Te BoxLayout. Constructo 

JButton buttonTwo = new JButton("bliss"); the Component it’s la i. ina to know 
panel.add (button) ; and which axis to eel, 9 out lie, the Panel) 
panel.add(buttonTwo) ; vertical stack). WEEE Y_AXIS for a 
frame.getContentPane().add(BorderLayout.EAST, panel); 


frame.setSize (250,200); 
frame.setVisible (true); 


; ¢ agjai™ 
a» how the panel is nat both iputtons 
| ‘- it doesn t nee e\ told the ane 
Pa ictal ee hor oly the OF 
pov ged enough 
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layout managers 


there, are_no 


Dumb Questions 


How come you can’t add directly to a frame the way 
you can to a panel? 


A: A JFrame is special because it’s where the rubber meets 
the road in making something appear on the screen. While 

all your Swing components are pure Java, a JFrame has to 
connect to the underlying OS in order to access the display. 
Think of the content pane as a 100% pure Java layer that sits 
on top of the JFrame. Or think of it as though JFrame is the 
window frame and the content pane is the...glass. You know, 
the window pane. And you can even swap the content pane 
with your own JPanel, to make your JPanel the frame's content 
pane, using: 


myFrame.setContentPane (myPanel) ; 


Q: Can I change the layout manager of the frame? What 
if | want the frame to use flow instead of border? 


A: The easiest way to do this is to make a panel, build the 
GUI the way you want in the panel, and then make that panel 
the frame's content pane using the code in the previous 
answer (rather than changing the default content pane). 


Q: What if | want a different preferred size? Is there a 
setSize() method for components? 


A: Yes, there is a setSize(), but the layout managers will 
ignore it. There's a distinction between the preferred size of 
the component and the size you want it to be. The preferred 
size is based on the size the component actually needs 

(the component makes that decision for itself). The layout 
manager calls the component's getPreferredSize() method, 
and that method doesn’t care if you've previously called 
setSize() on the component. 


Q: Can't I just put things where | want them? Can I turn 
the layout managers off? 


A: Yep. On a container-by-container basis, you can call 
setLayout (null), and then it’s up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, it’s almost always easier to use layout managers. 
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-——— BULLET POINTS 


Layout managers control the size and 
location of components nested within other 
components. 


When you add a component to another 
component (sometimes referred to as a 
background component, but that’s not a 
technical distinction), the added component 
is controlled by the layout manager of the 
background component. 


A layout manager asks components for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager’s 
policies, it might respect all, some, or none of 
the component’s wishes. 


The BorderLayout manager lets you add 

a component to one of five regions. You 
must specify the region when you add the 
component, using the following syntax: 
add (BorderLayout.EAST, panel); 


With BorderLayout, components in the north 
and south get their preferred height, but not 
width. Components in the east and west get 
their preferred width, but not height. The 
component in the center gets whatever is left 
over. 


FlowLayout places components left to right, 
top to bottom, in the order they were added, 
wrapping to a new line of components only 
when the components won't fit horizontally. 


FlowLayout gives components their preferred 
size in both dimensions. 


BoxLayout lets you align components stacked 
vertically, even if they could fit side-by-side. 
Like FlowLayout, BoxLayout uses the preferred 
size of the component in both dimensions. 
BorderLayout is the default layout manager 

for a frame's content pane; FlowLayout is the 
default for a panel. 


If you want a panel to use something other than 
flow, you have to call setLayout () onthe 
panel. 


using swing 


Playing with Swing components 


You've learned the basics of layout managers, so now let’s try out a few of the most 
common components: a text field, scrolling text area, checkbox, and list. We won’t show 
you the whole darn API for each of these, just a few highlights to get you started. If you 
do want to find out more, read Java Swing by Dave Wood, Marc Loy, and Robert Eckstein. 


JTextField 
eco 
Dog's first name: Frodo <—-} JTextField 
ypaed 
. \s. 
O means 10 columns vot etn of 
m re 
Constructors tl defines prexer 
JTextField field = new JTextField(20) ; the text Field. 


JTextField field = new JTextField("Your name") ; 


How to use it 


@ Get text out of it 
System.out.println (field.getText() ) ; 


@ Put text in it 


field. setText ("whatever") ; 


field.setText("") ; 


R__ This clears the field 


® Get an ActionEvent when the user ae register for ke events if 
presses return or enter ieee See ou about it every nee é 
ey. 


field. addActionListener (myActionListener) ; 


@ Select/Highlight the text in the field 
field.selectAl1l1 () ; 


© Put the cursor back in the field (so the user 
can just start typing) 


field. requestFocus () ; 
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text area 


JTextArea _— 


Hello, | am a text area. 


Unlike JTextField, JTextArea can have more than one line of 

text. It takes a little configuration to make one, because it doesn’t 
come out of the box with scroll bars or line wrapping. ‘To make a 
JTextArea scroll, you have to stick it in a JScrollPane. A JScrollPane 
is an object that really loves to scroll and will take care of the text 


area’s scrolling needs. 


ns 1O lines (sets 


10 mea Cevved neigh A 


Constructor the ye 


JTextArea text = new JTextArea(10, 20); 10 means 10 


R__ the preferred vid 


: _ oak the 

How to use it and ave it \\ for: 
Make 3 9 eats aging to °° 

@ Make it have a vertical scrollbar only ea that ' 


JScrollPane scroller = new JScrollPane (text) ; 
text.setLineWrap (true) ; 


Tell the seroll 
Pane to 
—, Turn on line wrapping fe a vertical scrollbar. ‘ 


scroller.setVerticalScrollBarPolicy (ScrollPaneConstants qe ieeeiaeanen 
scroller. setHorizontalScrollBarPolicy (ScrollPaneConstants .HORIZONTAL SCROLLBAR_NEVER) ; 


e only 


panel.add(scroller); ~ Importantll You give the + 4 
—— all ie tonstrutor). a7 10° 


@ Replace the text that's in it 


text.setText("Not all who are lost are wandering") ; 


@® Append to the text that's in it 


text.append ("button clicked") ; 


@ Select/highlight the text in the field 
text.selectAll() ; 


© Put the cursor back in the field (so the user 
can just start typing) 


text .requestFocus () ; 


524 chapter 15 


JTextArea example 


import javax.swing.*; 
import java.awt.*; 
import java.awt.event.*; 


public class TextAreal { 


public static void main(String[] args) { 


TextAreal gui = new TextAreal(); 
gui.go(); 


public void go() { 
JFrame frame = new JFrame(); 
JPanel panel = new JPanel (); 


JButton button = new JButton("Just Click It"); 


JTextArea text = new JTextArea(10 
text.setLineWrap (true) ; 


——a~ 
button.addActionListener(e -> text.append("button clicked \n")) ; 
—_— 


, 20); 


using swing 


button clicked 
button clicked 
button clicked 
button clicked 
button clicked 
button clicked 
button clicked 
button clicked 
button clicked 


Lambda expression to implement, the 
button’s ActionListener- 


JScrollPane scroller = new JScrollPane (text) ; 


scroller.setVerticalScroll1BarPolicy (Scrol1lPaneConstants.VERTICAL SCROLLBAR_ALWAYS) ; 


Just Click It 


Insert a new line so the 
Je on a separate line 


words 


each time the butte, 


n iS 


clicked. Otherwise, they'll 


run together 


scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants.HORIZONTAL SCROLLBAR_NEVER) ; 


panel .add(scroller) ; 


frame.getContentPane().add(Border 


Layout. CENT 


ER, panel); 


frame.getContentPane().add(Border 


frame.setSize(350, 300); 
frame.setVisible (true) ; 


Layout. SOu'i 


= 


H, button); 


Baton cietea 
pied Clicked b 
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check box 


JCheckBox 
eee 
() Goes to 11 


—_—_—_—_—_ 


Constructor 
JCheckBox check = new JCheckBox("Goes to 11"); 


How to use it 


@ Listen for an item event (when it's selected or deselected) 


check .addItemListener (this) ; 


@ Handle the event (and find out whether or not it's selected) 


public void itemStateChanged(ItemEvent e) { 
String onOrOff = "off"; 
if (check.isSelected()) { 
onOrOff = "on"; 
} 
System.out.println("Check box is " + onOrOff) ; 
} 


® Select or deselect it in code 


check.setSelected (true) ; 
check.setSelected (false) ; 
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there, are_no 


Dumb Questions 


: Aren't the layout managers 
just more trouble than they’re 
worth? If | have to go to all this 
trouble, | might as well just hard- 
code the size and coordinates for 
where everything should go. 


A: Getting the exact layout you 
want from a layout manager can be 


a challenge. But think about what 
the layout manager is really doing 
for you. Even the seemingly simple 
task of figuring out where things 
should go on the screen can be 
complex. For example, the layout 
manager takes care of keeping 

your components from overlapping 
one another. In other words, it 
knows how to manage the spacing 
between components (and between 
the edge of the frame). Sure, you 
can do that yourself, but what 
happens if you want components to 
be very tightly packed? You might 
get them placed just right, by hand, 
but that’s only good for your JVM! 


Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform's 
native “look and feel.” Subtle things 
like the bevel of the buttons can 
be different in such a way that 
components that line up neatly 

on one platform suddenly squish 
together on another. 


And we haven't even covered 

the really Big Thing that layout 
managers do. Think about what 
happens when the user resizes the 
window! Or your GUI is dynamic, 
where components come and 

go. If you had to keep track of 
re-laying out all the components 
every time there’s a change in the 
size or contents of a background 
component...yikes! 


using swing 


JList constru 
ctor takes an arr 
; ay of 
ied don't have to be Strings a ee 
9 Yepresentation w; we 
Constructor ‘on will appear in the list. 
String[] listEntries = {"alpha", "beta", "gamma", "delta", 
"epsilon", "zeta", "eta", "theta "}; 


JList<String> list = new JList<>(listEntries) ; 


ai JList is a generit Class, so Gk diamond operator 
you cen detlave what type ° from Chapter II. 


ects are in the list: 
How to use it aye 


@ Make it have a vertical scrollbar 


JScrollPane scroller = new JScrollPane (list) ; 
scroller.setVerticalScrol1lBarPolicy (ScrollPaneConstants.VERTICAL SCROLLBAR ALWAYS) ; 
scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants .HORIZONTAL SCROLLBAR_NEVER) ; 


panel .add (scroller) ; 


@ Set the number of lines to show before scrolling 


list.setVisibleRowCount (4) ; 


® Restrict the user to selecting only ONE thing at a time 


list.setSelectionMode (ListSelectionModel .SINGLE SELECTION) ; 


@ Register for list selection events 


list.addListSelectionListener (this) ; | - 
You'll get the event TWICE if you don 


© Handle events (find out which thing in the list was selected) put in this if test. 


public void valueChanged(ListSelectionEvent e) { 
if ('e.getValueIsAdjusting()) { 
String selection = list.getSelectedValue () ; getSeleetedV/alue() attuall 
System.out.println (selection) ; returns an Object A lt n't 
; isn 


| os 
limited to only String objects. 
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Code Kitchen 


" * 
* Code Kitchen 


vi 
5 ds ida. 
eee | Cyber BeatBox By 


Bass Drum Start 


Closed Hi-Hat () () () (1) 1) (1) 1) 1) 0) Je Stop 
Open Hi-Hat 

Acoustic Snare 
Crash Cymbal 

Hand Clap 

High Tom 

Hi Bongo 


Tempo Up 


Tempo Down 


Maracas 

Whistle 

Low Conga 

Cowbell 

Vibraslap 
Low-mid Tom 


High Agogo 


Open Hi Conga | e | 
—_—_—_—_—_—_—_—_—_—— 
This part's optional. We're making the full BeatBox, GUI 

and all. In Chapter 16, Saving Objects, we'll learn how 

to save and restore drum patterns. Finally, in Chapter 17, 

Make a Connection, we'll turn the BeatBox into a working 

chat client. 
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using swing 


Making the BeatBox 


This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code listing is complete, and fully annotated, but 
here’s the overview: 


@ 


Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 


Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e., as soon as the 
user checks a box). Instead, we wait until the user hits the “start” 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 


Set up the MIDI system (you've done this before) including getting 

a Sequencer, making a Sequence, and creating a track. We are using 

a sequencer method, setLoopCount(), that allows you to specify 

how many times you want a sequence to loop. We're also using the 
sequence's tempo factor to adjust the tempo up or down, and maintain 
the new tempo from one iteration of the loop to the next. 


When the user hits “start,” the real action begins. The event-handling 
method for the “start” button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at a 
time, a single instrument across all 16 beats) to get their state, and 
then use the information to build a MIDI track (using the handy 
makeEvent() method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because we're 
looping it) until the user hits “stop.” 


you are here > 


529 


BeatBox code 


import 
import 
import 
import 


javax.sound.midi.*; 
javax.swing.*; 
java.awt.*; 
java.util .ArrayList; 
import static javax.sound.midi.ShortMessage. *; 
public class BeatBox { 

private ArrayList<JCheckBox> checkboxList; 

private Sequencer sequencer; 

private Sequence sequence; 

private Track track; 


String[] instrumentNames {"Bass Drum", 
"Open Hi-Hat", "Acoustic Snare", 


We store the checkboxes in an 


AvrayList. 


These ave the names of the i . 
array, for building ° "i instruments, as a String 


the 4U| labels (on each row). 


"Closed Hi-Hat", 
"Crash Cymbal", 


"Hand Clap", 


"High Tom", "Hi Bongo", "Maracas", "Whistle", "Low Conga", 
"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", 
"Open Hi Conga"}; 
int[] instruments = {35, 42, 46, 38, 49, 39, 50, 60, 70, 72, 64, 56, 58, 47, 67, 63}; 


public static void main(String[] args) { 
new BeatBox() .buildGUI() ; 
} 


public void buildGUI() { 
JFrame frame new JFrame ("Cyber BeatBox") ; 


I. These represent the actual drum “keys.” 


The drum channel is like a pi 

hua Plano, exe +t 
eath ‘key’ on the piano is a differen 
drum. So the number “35” is the key for 
the Bass drum, 42. is Closed Hi-Hat, ete. 


frame .setDefaultCloseOperation (JFrame .EXIT_ON CLOSE) ; 


BorderLayout layout = new BorderLayout() ; 
JPanel background = new JPanel (layout) ; 


background. setBorder (BorderFactory.createEmptyBorder (10, 


Pa An “empty border” 


Box buttonBox new Box (BoxLayout.Y_ AXIS) ; 
JButton start = new JButton ("Start") ; 
start.addActionListener(e -> buildTrackAndStart() ) ; 


buttonBox.add(start) ; 


JButton stop = new JButton("Stop") ; 
stop.addActionListener(e -> sequencer.stop()) ; 
buttonBox.add (stop) ; —————————— 


JButton upTempo new JButton("Tempo Up") ; 
upTempo.addActionListener(e -> changeTempo(1.03f) ); 


buttonBox.add(upTempo) ; 


JButton downTempo new JButton("Tempo Down") ; 


10, 10, 10)); 


Gives us a margin 


etween the edges of the Panel and 


where the ¢ 
Purely Te ai are placed. 


Lambda expressions ave perfect ia ies 
event handlers, since when these u 4 . 
are pressed, all we want to do is ¢a 


specific method. 


) 
Oo 1s |.0, so Mere 


R. The default ene per eliek. 


adjusting 


downTempo.addActionListener(e -> changeTempo(0.97f) ) ; 


buttonBox.add(downTempo) ; 
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using swing 


This bor 


der 


name } On €a¢h ins 
Box nameBox = new Box (BoxLayout.Y_ AXIS) ; cheeky them line rot 
es. 1 h 
e 


for (String instrumentName : instrumentNames) { 
JLabel instrumentLabel = new JLabel (instrumentName) ; 
instrumentLabel .setBorder (BorderFactory.createEmptyBorder(4, 1, 4, 1)); 
nameBox.add(instrumentLabel) ; 


} 


background.add(BorderLayout.EAST, buttonBox) ; CHill more Gul setup code. 
background. add (BorderLayout.WEST, nameBox) ; Nothing, remarkable. 
frame .getContentPane () .add (background) ; khis one 
is 0 

4 manage . 
GridLayout grid = new GridLayout(16, 16) ; Another es Lomponents ince 
grid.setVgap (1) ; lets you P¥ ¢ and Columns 
grid.setHgap (2) ; grid with row 


JPanel mainPanel = new JPanel (grid) ; 
background. add (BorderLayout.CENTER, mainPanel) ; 


checkboxList = new ArrayList<>() ; 

for (int i= 0; i < 256; i++) { 
JCheckBox c = new JCheckBox () ; 
c.setSelected (false) ; 
checkboxList.add(c) ; 
mainPanel .add(c) ; 


} 


Make the checkboxes, set them to 


false’ (so the ’ 

Y arent checked), and 
add them to h 4 von 
the GU panel © NV2YList AND to 


setUpMidi () ; 


frame.setBounds (50, 50, 300, 300); 
frame. pack () ; 
frame.setVisible (true) ; 


} 


private void setUpMidi() { 


try { Th 
sequencer = MidiSystem.getSequencer () ; ae rey na plone for 
sequencer. open () ; and the Teak ie ) in Sequence, 
sequence = new Sequence (Sequence.PPQ, 4); gain, no Ing special. 


track = sequence.createTrack () ; 
sequencer .setTempoInBPM (120) ; 


} catch (Exception e) { 
e.printStackTrace () ; 
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BeatBox code 


eit all happens! Where we 


This is wher 
h sbox state into MID\| events bo hold the values for : 
turn che T ack 51 beelement array ks \f the anstirumen 
and add them to the [rack We ae es all Ib beats: Ft that elemen 
strumen©s £ peat, the ¥ osed 
a cae to play on be ctrument is NOT svFP 
private void buildTrackAndStart() { wat he the Key: \f aed seer: 
int[] trackList; << lay on th beats PY en 
one. 
sequence .deleteTrack (track) ; Get vid of the old track, make a rres 
track = sequence.createTrack () ; ib ROWS he Gas Congo, ete.) 


EZ i ath of the 

for (int i = 0; i < 16; itt) { do this for e panied 

trackList = new int[16]; Cet the “bey” that represents shi ment is 
(Bass, Hi-Hat, ete.). The instruments array 


: _ ‘ 1 env. 
int key = instruments [4] ; a setual MIDI numbers for each insbrum 


a Do this for each of the BEATS Lov this row: 
for (int j = 0; 3 < 16; j++) { 
JCheckBox jc = checkboxList.get(j + 16 * i); 


if (jc.isSelected 
: ek c ae Is the checkbox at this beat selected? If yes, put 


} else { the key value in this slot in the array (the slot that 
trackList[j] = 0; represents this beat). Otherwise, the instrument is 
} NOT supposed to play at this beat, so set it to zero. 


} 
For this instrument, and for all 1 = 
makeTracks (trackList) ; <= ~ make events and add them to the track. 
track.add(makeEvent (CONTROL CHANGE, 1, 127, 0, 16)); 
} 
We always want to make sure that there [S an 
track.add(makeEvent (PROGRAM CHANGE, 9, 1, 0, 15)); event at beat 16 (it goes O to 15). Otherwise, the 
BeatBox might not go the full 16 beats before it 
starts over. 
try { 
sequencer .setSequence (sequence) ; 
sequencer .setLoopCount (sequencer .LOOP_ CONTINUOUSLY); &—~ wae you speci fy the number 


Se encae siobiely: raea ; of loop iterations, or in this 
sequencer.start() ; : hacia: 
case, Continuous loopin 
} catch (Exception e) { ae Now PLAY THE ase, Png, 
e.printStackTrace () ; THING!! 
} 
} 
private void changeTempo (float tempoMultiplier) { The Tempo Factor seales the 
float tempoFactor = sequencer.getTempoFactor () ; sequencers tempo by the factor 


} 
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sequencer.setTempoFactor (tempoFactor * tempoMultiplier) ; provided, slowing, the beat down or 


speeding it up. 


chapter 15 


using swing 


e instrument ata time, Lor 


is m ts for on 
a we sees it might a an intL 7 neha hee 
dium, and each index in the array w! if e 


private void makeTracks(int[] list) { the key of that instrument or a rahe te ' —* 
for (int i = 0; i < 16; i++) { Lhe incbeument isn’t supposed to pla ‘s irene 
int key = list[i]; Otherwise, make an event and add i 
if (key '= 0) { 
track.add(makeEvent (NOTE ON, 9, key, 100, i)); Make the NOTE ON and 
track.add(makeEvent (NOTE OFF, 9, key, 100, i + 1)); 4 NOTE OFF events, and 
} 7 add them to the Track. 


} 
} 


public static MidiEvent makeEvent(int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage() ; This is the ui 
msg.setMessage (cmd, chnl, one, two) ; Previous ne i 
event = new MidiEvent(msg, tick) ; 0 hing eu 
catch (Exception e) { 
e.printStackTrace () ; 


lity method £ 
pter’s Cod ek, ie the 


~ 


} 


return event; 


} 
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exercise: Which Layout? 


Which code goes with 
which layout? 


Five of the six screens below were made from one 
of the code fragments on the opposite page. Match 
each of the five code fragments with the layout that 


fragment would produce. 


eee 
= eee 
tesuji 
5 | 5 | 


tesuji 


— 
& 


tesuji 
4] N 
6 ) [eee 
tesuji 
tesuji 
EE 


————+ Answers on page 537. 
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Code Fragments 


JFrame frame = new JFrame () ; 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 

JButton button = new JButton("tesuji") ; 

JButton buttonTwo = new JButton("watari") ; 
panel .add (button) ; 

frame .getContentPane () .add(BorderLayout.NORTH, buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel) ; 


using swing 


JFrame frame new JFrame () ; 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 

JButton button = new JButton("tesuji") ; 

JButton buttonTwo = new JButton("watari") ; 

panel .add (buttonTwo) ; 

frame .getContentPane() .add(BorderLayout.CENTER, button) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel) ; 


JFrame frame new JFrame () ; 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 

JButton button = new JButton("tesuji") ; 

JButton buttonTwo = new JButton("watari") ; 

panel . add (buttonTwo) ; 

frame .getContentPane() .add(BorderLayout.CENTER, button) ; 


JFrame frame new JFrame () ; 

JPanel panel = new JPanel (); 

panel .setBackground (Color.darkGray) ; 

JButton button = new JButton("tesuji") ; 

JButton buttonTwo = new JButton("watari") ; 

frame .getContentPane() .add(BorderLayout.NORTH, panel) ; 
panel .add (buttonTwo) ; 

frame .getContentPane() .add(BorderLayout.CENTER, button) ; 


JFrame frame = new JFrame() ; 

JPanel panel = new JPanel(); 

panel .setBackground (Color.darkGray) ; 

JButton button = new JButton("tesuji") ; 

JButton buttonTwo = new JButton ("watari") ; 

frame .getContentPane() .add(BorderLayout.SOUTH, panel) ; 
panel . add (buttonTwo) ; 

frame.getContentPane() .add(BorderLayout.NORTH, button) ; 
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puzzle: crossword 


Down 


Across 

1. Artist's sandbox 
4. Border’s catchall 
5. Java look 

9. Generic waiter 
11. Ahappening 

12. Apply a widget 
15. JPanel's default 
16. Polymorphic test 
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17. Shake it, baby 
21. Lots to say 
23. Choose many 
25. Button’s pal 
26. Home of 


actionPerformed 


2. Swing’s dad 

3. Frame's purview 
5. Help’s home 

6. 
7 
8 
9 


More fun than text 


. Component slang 
. Romulin command 


. Arrange 


10. Border's top 


13. 
14. 
15. 
18. 
19, 
20. 
22. 
24. 


You can do it. 


Manager's rules 
Source’s behavior 
Border by default 
User's behavior 
Inner’s squeeze 
Backstage widget 
Classic Mac look 


Border’s right 


—————> Answers on page 538. 


using swing 


Exercise SoLutions 


Which cade gees with which layout? 
(from pages 534-535) 


e006 JFrame frame = new JFrame() ; 
@ GC) JPanel panel = new JPanel (); 
panel .setBackground (Color. darkGray) ; 
JButton button = new JButton("tesuji") ; 
cess JButton buttonTwo = new JButton("watari") ; 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.CENTER, button) ; 


JFrame frame = new JFrame () ; 
© JPanel panel = new JPanel () ; 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
tesuji JButton buttonTwo = new JButton ("watari") ; 
frame .getContentPane() .add(BorderLayout.NORTH, panel) ; 
panel. add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.CENTER, button) ; 


JFrame frame = new JFrame() ; 
'E) JPanel panel = new JPanel(); 
panel .setBackground (Color. darkGray) ; 
JButton button = new JButton("tesuji") ; 
JButton buttonTwo = new JButton("watari") ; 
frame .getContentPane() .add(BorderLayout.SOUTH, panel) ; 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.NORTH, button) ; 


(eee 
¢€ watari 


JFrame frame = new JFrame() ; 
A) JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
JButton buttonTwo = new JButton("watari") ; 
panel .add (button) ; 
frame .getContentPane() .add(BorderLayout.NORTH, buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel) ; 


JFrame frame = new JFrame() ; 
B ) JPanel panel = new JPanel(); 
panel .setBackground (Color.darkGray) ; 
JButton button = new JButton("tesuji") ; 
cepa JButton buttonTwo = new JButton("watari") ; 
panel .add (buttonTwo) ; 
frame .getContentPane() .add(BorderLayout.CENTER, button) ; 
frame .getContentPane() .add(BorderLayout.EAST, panel) ; 
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puzzle answers 


GUI-Cr ass (from page 536) 


'DIR|AIW] PIA] NIE IL 
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U 
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16 serialization and file I/O 


Saving Objects (and Text) 


If I have to read 
one more file full 
of data, I think I'll have to kill him. 
ne) He knows I can save whole objects, but 
does he let me? NO, that would be 
too easy. Well, we'll just see how 
he feels after T... 


Objects can be flattened and inflated. Objects have state and behavior. Behavior lives in 
the class, but state lives within each individual object. So what happens when it’s time to save the state of an 
object? If you're writing a game, you're gonna need a Save/Restore Game feature. If you're writing an app 
that creates charts, you’re gonna need a Save/Open File feature. If your program needs to save state, you can 
do it the hard way, interrogating each object, then painstakingly writing the value of each instance variable 
to a file, in a format you create. Or, you can do it the easy OO way—you simply freeze-dry/flatten/persist/ 
dehydrate the object itself, and reconstitute/inflate/restore/rehydrate it to get it back. But you'll still have to 
do it the hard way sometimes, especially when the file your app saves has to be read by some other non-Java 
application, so we'll look at both in this chapter. And since all I/O operations are risky, we'll take a look at how 


to do even better exceptions handling. 
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saving objects 


Capture the beat 


You've made the perfect pattern. You want to save the pattern. You 


could grab a piece of paper and start scribbling it down, =e as 
but instead you hit the Save button (or choose Save goss DU" o e O° . 200 c Ja 
from the File menu). Then you give it aname, pick a — ggsed iM = C) | - 


directory, and exhale knowing that your masterpiece open ¥i-"'** eee eee 
. 5 ic nat poe hot 
won’t go out the window during a random computer —_acous#® e 


crash, es one . D : e 
You have lots of options for how to save the state of High TO™ eo? 
your Java program, and what you choose will probably * ai eo°CYVaAc 
depend on how you plan to wse the saved state. Here are eee ef. 
the options we’ll be looking at in this chapter. Low conga s 
iN -) 
If your data will be used by only the se a8 
Java program that generated it: Caen eee 
ee Hi Cong 


@ Use serialization 


Write a file that holds flattened (serialized) objects. 
Then have your program read the serialized objects 
from the file and inflate them back into living, 
breathing, heap-inhabiting objects. 


If your data will be used by other programs: 


@ Write a plain-text file 


Write a file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
database application can use. 


These aren’t the only options, but if we had to pick only two approaches to doing 
I/O in Java, we’d probably pick these. Of course, you can save data in any format 
you choose. Instead of writing characters, for example, you can write your data as 
bytes. Or you can write out any kind of Java primitive as a Java primitive—there are 
methods to write ints, longs, booleans, etc. But regardless of the method you use, the 
fundamental I/O techniques are pretty much the same: write some data to something, 
and usually that something 1s either a file on disk or a stream coming from a network 
connection. Reading the data is the same process in reverse: read some data from 
either a file on disk or a network connection. Everything we talk about in this part 1s 
for times when you aren’t using an actual database. 
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Saving state 


Imagine you have a program, say, a fantasy adventure 
game, that takes more than one session to complete. 
As the game progresses, characters in the game 
become stronger, weaker, smarter, etc., and gather 
and use (and lose) weapons. You don’t want to start 
from scratch each time you launch the game—it took 
you forever to get your characters in top shape for a 
spectacular battle. So, you need a way to save the state 
of the characters, and a way to restore the state when 
you resume the game. And since you’re also the game 
programmer, you want the whole save and restore 
thing to be as easy (and foolproof) as possible. 


@ Option one 


Write the three serialized 
character objects to a file 


Create a file and write three serialized 
character objects. The file won't make 
sense if you try to read it as text: 


“IsrGameCharacter 
“%gé8MUIpowerLjava/lang/ 
String; [weaponst [Ljava/lang/ 
String;xp2tlfur [Ljava.lang.String;#“VA 
E{Gxptbowtswordtdustsq~ »tTrolluq” tb 
are handstbig axsq” xtMagicianugqg” tspe 
lstinvisibility 


@ Option two 
Write a plain-text file 


Create a file and write three lines of text, 
one per character, separating the pieces 
of state with commas: 


50,Elf,bow, sword,dust 
200,Troll,bare hands, big ax 
120,Magician,spells,invisibility 


serialization and file I/O 


Imagine 
have thr ng 


characters 45 Se 


GameCharacter 


int power 
String type 
Weapon|] weapons 


getWeapon() 
useWeapon() 
increasePower() 
// more 


The sevialized f; 


but le is much hard 
hed t : fea Ries (and safe) for hema to read 
reading in the ie objects From Serializati fe Na 
a text file. an — S variable values tha is a 
: mPle, i ; e€ sa 
You ould accidentally read bert Ne Ways in mri - 
e 


order! Th 
while the EI re might become “ " oe in the wrong 
n... 


becomes a weapo; 
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saving objects 


Writing a serialized object to a file 


Here are the steps for serializing (saving) an object. Don’t bother 
memorizing all this; we’ll go into more detail later in this chapter. 


» ey £ 
‘le “MyGame-ser doesn t 
sig Ke be treated automatically. 
® Make a FileOutputStream y 


FileOutputStream fileStream = new FileOutputStream("MyGame.ser") ; 


Make a FileOut 


nows how to 


PutStream ob; 
Connee. tt (abject FileOutput-c tyes. 


Create) g file. 


2) Make an ObjectOutputStream 


ObjectOutputStream os = new ObjectOutputStream (fileStream) ; 


ste obiects, 
Objet se Ln os Cle It nee 


but it cant diveetly se attually called 


to be fed 3 RelRee ther. 


“ehaining” one stream 


3) Write the object by characterOne, 
ee cerns the Sa ad 
os .writeObject (characterOne) ; character Two, by the File “MyGame-ser- 
os .writeObject (characterTwo) ; them in this order 


os.writeObject (characterThree) ; 


4) Close the ObjectOutputStream 
k-™™~" 
Closing the stream at the top closes the ones 


underneath, s ties 
le) vil cose atomatna Se (and the 


os.close() ; 
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serialization and file I/O 


Data moves in streams from one place to another 


Connection 
Streams represent 
a connection to a 
: Kit. souree of destination 

a | (file, network socket, 

at ey, abs: bal\ etc.), while chain 
—s = streams can’t connect 
on their own and 
must be chained to a 
connection stream. 


The Java I/O API has connection streams, which represent connections to destinations and 
sources such as files or network sockets, and chain streams that work only if chained to other 
streams. 


Often, it takes at least two streams hooked together to do something useful—one to represent the 
connection and another to call methods on. Why two? Because connection streams are usually too 
low-level. FileOutputStream (a connection stream), for example, has methods for writing bytes. 
But we don’t want to write bytes! We want to write objects, so we need a higher-level chain stream. 


OK, then why not have just a single stream that does exactly what you want? One that lets you 
write objects but underneath converts them to bytes? Think good OO. Each class does one thing 
well. FileOutputStreams write bytes to a file. ObjectOutputStreams turn objects into data that 
can be written to a stream. So we make a FileOutputStream (a connection stream) that lets us 
write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. When we 
call writeObject() on the ObjectOutputStream, the object gets pumped into the stream and then 
moves to the FileOutputStream where it ultimately gets written as bytes to a file. 


The ability to mix and match different combinations of connection and chain streams gives you 

tremendous flexibility! If you were forced to use only a single stream class, you'd be at the mercy 

of the API designers, hoping they’d thought of everything you might ever want to do. But with 

chaining, you can patch together your own custom chains. Destination 


01101001 


Object is flattened (serialized) Object is written as bytes to 01101110 
———__ ; - 011010010110111001 01 
is written to is chained to 
Object ObjectOutputStream FileOutputStream File 
(a chain stream) (a connection stream) 
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serialized objects 


What really happens to an object 
when it’s serialized? 


Gi) Object on the heap (2) Object serialized 


Objects on the heap have state— Serialized objects save the values 
the value of the object's instance of the instance variables so that 
variables. These values make one an identical instance (object) can be 


instance of aclass different from 


brought back to life on the heap. 
another instance of the same class. 


90100101 The instance variable values 


Oye re ables ance for width and hei > 
inseante sia . . = cked 01000110} saved to the file us on 
ae) 


'00.Ser, 
The values ave 2 along with a litt] 
out and pumped in the JVM ek . ise 
Lhe stream the object (like what its 
tlass ype is). 


.* 00.ser 
width — height 


FileOutputStream fs = new FileOutputStream("foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs) ; 
os.writeObject (myFoo) ; 


Make a Fil 
Foo myFoo = new Foo() ; ‘ bage sible ia ie connects 
myFoo. setWidth (37) ; ObjectOutputStrean, ie i ae es ‘ 
Denard ObjectOutput Stream to write the roam 
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serialization and file I/O 


But what exactly IS an objects state? 


What needs to be saved? 


Now it starts to get interesting. Easy enough to save the primitive values 

37 and 70. But what if an object has an instance variable that’s an object 
reference? What about an object that has five instance variables that are 
object references? What if those object instance variables themselves 


have instance variables? 


Think about it. What part of an object is potentially unique? Imagine 
what needs to be restored in order to get an object that’s identical to the 
one that was saved. It will have a different memory location, of course, 
but we don’t care about that. All we care about is that out there on the 
heap, we'll get an object that has the same state the object had when it 
was saved. 


==) 


What has to happen for the Car 
object to be saved in sucha 
way that it can be restored to its 
original state? 


Think of what—and how—you 
might need to save the Car. 


And what happens if an Engine 
object has a reference to a 
Carburetor? And what's inside the 
Tire[] array object? 


The Car object has two 
instance variables that 
reference two other 
objects. 


ine oe 


Engine Tire [] 


What does it take to 
save a Car object? 
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serialized objects 


When an object is serialized, all the objects 
it refers to from instance variables are also : . 
serialized. And all the objects those objects entire object gr aph— 
refer to are serialized. And all the objects those all objects referenced 
objects refer to are serialized...and the best part 
is, it happens automatically! 


Serialization saves the 


by instance variables, 
starting with the 


Dog[] holds references to two Dog objects. Each Dog object holds object being serialized. 
a reference to a String and a Collar object. The String objects 
have a collection of characters, and the Collar objects have an int. 


This Kennel object has a reference to a Dog[] array object. The 


When you save the Kennel, all of this is saved! 
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serialization and file I/O 


If you want your class to be serializable, 


a a Serializable 


The Serializable interface is known as a marker or tag interface, because the 
interface doesn’t have any methods to implement. Its sole purpose 1s to 
announce that the class implementing it is, well, serzalzzable. In other words, 
objects of that type are saveable through the serialization mechanism. 
If any superclass of a class is serializable, the subclass is automatically 
serializable even if the subclass doesn’t explicitly declare “implements 
Serializable.” (‘This is how interfaces always work. If your superclass “IS-A’ k 
MUST implemen 
of} natever — al Meal at cuntime- 
objectOutputStream.writeObject (mySquare) ; Cevializa €° 


Serializable, you are too.) 


e ene package ey 


Seria glizable is in the 
ow sd 
import java.io.*; d the but when you 
<~ y ou need No methods to rapt : £ says to the JVM, 
Serial izable, 
lic cl re lizabl lements his type: 
public class Square een { fo Ox. to serialize objects “thi YP 
private int width; 
private int height; <~ These two values will be saved. 
public Square(int width, int height) { 
this.width = width; 
this.height = height; 
} 00:Ser 
ile nam a 
public static void main(String[] args) { Connett + “f ik doesn ts make 
Square mySquare = new Square(50, 20); if it enise 4 “foo-ser: 
: throw exceptions: new {ile name 
| /0 operations can 
try { eo 
FileOutputStream fs = new FileOutputStream("foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs) ; 
os .writeObject (mySquare) ; Make ano 
os.close() ; PN chained to bie CtOutputStres 
} catch (Exception ex) { Tell ni bs e Connection, stream 
ex. printStackTrace () ; : Wri . 
P te the object 
} 
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serialized objects 


Serialization is all or nothing. 


Can you imagine what would 
happen if some of the object’s 
state didn’t save correctly? Eeewww! That 

creeps me out just thinking 
about it! Like, what if a Dog comes 
back with no weight. Or no ears. Or 
the collar comes back size 3 instead 
of 30. That just can't be allowed! 


Either the entire 
object graph is 
serialized correctly 
or serialization fails. 


You can’t serialize 
a Pond object if 
import java.io.*; its Duck instance 


Y__~ Pond objects tan be serialized, Variable refuses to 
public class Pond implements Serializable { _ 
be serialized (by 


1 stance 
Class Pond has one not implementing 


Duck. 
Serializable). 


private Duck duck = new Duck() ; €—— 
variable, aw 


public static void main(String[] args) { 
Pond myPond = new Pond() ; 
try { 
FileOutputStream fs = new FileOutputStream("Pond.ser") ; 
ObjectOutputStream os = new ObjectOutputStream (fs) ; 


we ; 
os .writeObject (myPond) ; When ie Serialize m Pond (a Pond 
os.close() ; a . i ‘i 
} catch (Exception ex) { M matically gets serialized, 
ex.printStackTrace () ; “nw in Class Pond: 
When you try to run the main | 


File Edit Window Help Regret 


BENS Bone zableException: puet 


z jali 
+ ava.io.NotSeri4 ; a.java:13) 
[he Duck is not serializable! ae at Pond.main (Pond. J 


t doesn’t implement Serializable, 
public class Duck { so when you try to serialize a 


// duck code here Pond et it fails because the 


} Pond’s uck instance variable 
can t be saved. 
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serialization and file I/O 


screwed if the idiot who wrote the 
class for my instance variable forgot 
to make it Serializable? 


It's hopeless, 
then? I'm completely 


Mark an instance variable as transient 
if it can’t (or shouldn’t) be saved. 


If you want an instance variable to be skipped by the serialization 
process, mark the variable with the transient keyword. 


import Jjava.net.*; 


ek 

beansient =e dur class Chat implements Serializable { 
‘ ole 1) . s . 
eave this ie ys gkig ¥t- ytransient String currentID; 


yore String userName; 


The userName variable // more code 
will be saved as part } 


of the object's state 


during serialization. 


If you have an instance variable that can’t be saved because it isn’t 
serializable, you can mark that variable with the transient keyword 
and the serialization process will skip right over it. 


So why would a variable not be serializable? It could be that 

the class designer simply forgot to make the class implement 
Serializable. Or it might be because the object relies on runtime- 
specific information that simply can’t be saved. Although most 
things in the Java class libraries are serializable, you can’t save 
things like network connections, threads, or file objects. They’re all 
dependent on (and specific to) a particular runtime “experience.” 
In other words, they’re instantiated in a way that’s unique to a 
particular run of your program, on a particular platform, in a 
particular JVM. Once the program shuts down, there’s no way to 
bring those things back to life in any meaningful way; they have to 
be created from scratch each time. 
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serialized objects 


there, are_no 


Dumb Questions 


Q: If serialization is so important, 
why isn’t it the default for all classes? 
Why doesn’t class Object implement 
Serializable, and then all subclasses 

will be automatically Serializable? 


2 Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to “enable” serialization 
by implementing Serializable. 

First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 

a lack of functionality, so the model 

of polymorphism wouldn't work 
correctly if you had to say, “implements 
NonSerializable’” to tell the world that 
you cannot be saved. 


+ Why would | ever write a class 
that wasn’t serializable? 


2 There are very few reasons, but 
you might, for example, have a security 
issue where you don’t want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there’s 
no useful way for you to make your 
class serializable. 


Q: If a class I’m using isn’t 
serializable but there’s no good 
reason, can | subclass the “bad” class 
and make the subclass serializable? 
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A: Yes! If the class itself is 
extendable (i.e., not final), you can 
make a serializable subclass and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) That brings up another 
interesting issue: what does it mean if 
the superclass is not serializable? 


Q: You brought it up: what does it 
mean to have a serializable subclass 
of anon-serializable superclass? 


A: First we have to look at what 
happens when a class is deserialized, 
(we'll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there's 
no decent reason for a class to not 

be serializable, making a serializable 
subclass might be a good solution. 


+ Whoa! just realized 
something big...if you make a 
variable “transient,” this means 
the variable’s value is skipped over 
during serialization. Then what 
happens to it? We solve the problem 
of having a non-serializable instance 
variable by making the instance 
variable transient, but don’t we NEED 
that variable when the object is 
brought back to life? In other words, 
isn’t the whole point of serialization 
to preserve an object's state? 


A: Yes, this is an issue, but 
fortunately there’s a solution. If 
you serialize an object, a transient 


reference instance variable will be 
brought back as null, regardless of the 
value it had at the time it was saved. 
That means the entire object graph 
connected to that particular instance 
variable won't be saved. This could be 
bad, obviously, because you probably 
need a non-null value for that variable. 


You have two options: 


1. When the object is brought back, 
reinitialize that null instance variable 
back to some default state. This 

works if your deserialized object isn’t 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same, so it doesn’t 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 


2. If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog), then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that's identical to the original. 


: What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object. Does the Owner get saved 
twice? I’m hoping not. 


A: Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization, any 
references to that single object are 
restored. 
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a a a a a 

Veserialization: restoring an object dese 

The whole point of serializing an object is so that you can restore it serialized y 

to its original state at some later date, in a different “run” of the JVM / 

(which might not even be the same JVM that was running at the time Ls 

the object was serialized). Deserialization is a lot like serialization in — pe 

reverse. ° . 

) ’ 
yw z : doesn t 

. If the file MyGame o Lor 

@ Make a FileInputStream ¢ exist, Youll get an encef 
——_—_——_—_—_——— 


FileInputStream fileStream = new FileInputStream("MyGame.ser") ; 


2) Make an ObjectInputStream 


ObjectInputStream os = new ObjectInputStream (fileStream) ; 


d obi etts, 
‘ +Stream lets you rea \e° 
eat mee see sett ta Be 
be chaine ‘i 
Taoaagege ease a FilelnputStrea 
Ss ) Read the objects 
Object one = os.readObject() ; Each time you say readObject(), 
Object two = os.readObject() ; object in the stream. So youl iO eve the next 


h ae 
Object. theres] cs. ceadopject (is ve pet igs in which they were written. You'll 


objects than Pigaieis ‘ you try to read more 


4.) Cast the objects 


GameCharacter elf = (GameCharacter) one; 
GameCharacter troll = (GameCharacter) two; 
GameCharacter magician = (GameCharacter) three; ty. veturn value of ical 
F___veaddbjectt) is tyre ee 
(ust like with PrerayList 
®) st it back 
ou have te Gee TE veally is 
5) Close the ObjectInputStream he type You Know ' 
,eL ; . 
os.close() Closing the stream at the top closes + 
underneath, so the Filelnput pear hart ies 
File) will close automa tically. ream (and the 
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What happens during deserialization? 


When an object is deserialized, the JVM attempts to bring the 
object back to life by making a new object on the heap that has the 
same state the serialized object had at the time it was serialized. 
Well, except for the transient variables, which come back either null 


(for object references) or as default primitive values. 


01101001 
01101110 


01 


552 


is read by 


File 
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tan f 


Class is found and loaded, saved 
instance variables reassigned 


011010010110111001 


Object is read as bytes 


-\\ throw 3h 
T ws et ye load the 


cpteplioe 
class’ 


FileInputStream ObjectInputStream 


(a connection stream) (a chain stream) 


G The object is read from the stream. 


The JVM determines (through info stored with 
the serialized object) the object's class type. 


The JVM attempts to find and load the ob- 
ject's class. If the JVM can't find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 


A new object is given space on the heap, but 
the serialized object's constructor does NOT 
run! Obviously, if the constructor ran, it would 
restore the state of the object to its original 
“new" state, and that's not what we want. We 
want the object to be restored to the state 

it had when it was serialized, not when it was 
first created. 


tthe VM 


+ 


O 


Object 


5 ] If the object has a non-serializable class 
somewhere up its inheritance tree, the 
constructor for that non-serializable class 
will run along with any constructors above 
that (even if they're serializable). Once the 
constructor chaining begins, you can't stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 


6 ] The object's instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
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primitives. 


there, are_no 


Dumb Questions 


: Why doesn’t the class get saved as part of the 
object? That way you don’t have the problem with 
whether the class can be found. 


A: Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while it might not be such a hardship when you're using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 


For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
“stamped” with a URL for where its class can be found. This 
is used in Java's Remote Method Invocation (RMI) so that 


you can send a serialized object as part of, say, a method 
argument, and if the JVM receiving the call doesn’t have the 
class, it can use the URL to fetch the class from the network 
and load it, all automatically. You may see RMI used in the 
wild, although you may also see objects serialized to XML 
or JSON (or other human-readable formats) to send over a 
network. 


Q: What about static variables? Are they serialized? 


A: Nope. Remember, static means “one per class” not 
“one per object.’ Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable its 
class currently has. The moral: don’t make serializable objects 
dependent on a dynamically changing static variable! It 
might not be the same when the object comes back. 
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Saving and restoring the game characters 


import java.io.*; 


public class GameSaverTest { i 
public static void main(String[] args) { Make some characters. 


GameCharacter on 


GameCharacter two 


= new GameCharacter(50, "Elf", 


new String[]{"bow", "sword", "dust"}); 


GameCharacter thr 


= new GameCharacter(200, "Troll", 
new String[]{"bare hands", "big ax"}); 


= new GameCharacter(120, "Magician", 
new String[]{"spells", "invisibility"}); 


// imagine code that does things with the characters that changes their state values 


try { 


ObjectOutputStream os = new ObjectOutputStream (new FileOutputStream("Game.ser") ) ; 
os.writeObject (one) ; 


Seriali 
os .writeObject (two) ; idlize the Charactey, 
os.writeObject (three) ; : 


os.close(); 


} catch (IOException ex) { 
ex.printStackTrace(); 


Now vead them back in from the file... 


try { 
ObjectInputStream is = new ObjectInputStream(new FileInputStream("Game.ser") ) ; 
GameCharacter oneRestore = (GameCharacter) is.readObject() ; acters: 
GameCharacter twoRestore = (GameCharacter) is.readObject() ; Restore the char 
GameCharacter threeRestore = (GameCharacter) is.readObject() ; 
System.out.printlin("One's type: " + oneRestore.getType()); Cheek to see if it worked 
System.out.printlin("Two's type: " + twoRestore.getType()); <— 
System.out.printlin("Three's type: " + threeRestore.getType()); 

} catch (Exception ex) { 

( 


ex.printStackTrace 


\e 


File Edit Window Help Resuscitate 


% java GameSaverTest 


One’s type: Elf 


Two’s type: Troll 


Three’s 
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type: Magician 
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The GameCharacter class 


import java.io.*; 
import java.util.Arrays; 


ust for testing 


we ; ass \ 
This is a basi¢ class Je on the last 


public class GameCharacter implements Serializable { the Serialization tod 


val game 
private final int power; aoe. We don't Hee i . ay : 
private final String type; but we'll leave 
private final String[] weapons; experiment: 


public GameCharacter(int power, String type, String[] weapons) { 
this.power = power; 
this.type = type; 
this.weapons = weapons; 


} 


public int getPower() { 
return power; 


} 


public String getType() { 
return type; 


} 


public String getWeapons() { 
return Arrays.toString (weapons) ; 


} 
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Version ID: A big serialization gotcha 


Now you've seen that I/O in Java is actually pretty simple, especially if you 
stick to the most common connection/chain combinations. But there’s one 
issue you might veally care about. 


Version Control is crucial! 


If you serialize an object, you must have the class in order to deserialize 
and use the object. OK, that’s obvious. But it might be less obvious what 
happens if you change the class in the meantime. Yikes. Imagine 
trying to bring back a Dog object when one of its instance variables 
(non-transient) has changed from a double to a String. That violates 
Java’s type-safe sensibilities in a Big Way. But that’s not the only change 
that might hurt compatibility. Think about the following: 


Changes to a class that can hurt deserialization: 
¢ Deleting an instance variable 

¢ Changing the declared type of an instance variable 

¢ Changing a non-transient instance variable to transient 

¢ Moving a class up or down the inheritance hierarchy 


¢ Changing a class (anywhere in the object graph) from Serializable to 
not Serializable (by removing ‘implements Serializable’ from a class 
declaration) 


¢ Changing an instance variable to static 


Changes to a class that are usually OK: 


¢ Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn’t 
have when they were serialized) 


e Adding classes to the inheritance tree 
* Removing classes from the inheritance tree 


¢ Changing the access level (public, private, etc.) of an instance 
variable has no effect on the ability of deserialization to assign a 
value to the variable 


e Changing an instance variable from transient to non-transient 
(previously serialized objects will simply have a default value for the 
previously transient variables) 
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@) You write a Dog class. 


Dog.class 


@ You serialize a Dog object 
using that class. 


OC) <=. 


Dog obo . is i 
Ob ee me 


4128 
Dog.class 


You deserialize a Dog object 
using the changed class. 


Sos sess 


100001 1010 


0 00110101 


Obiect is 1011010 

loved with Dog.class 

version — sergon 
#118 


© Serialization fails! 


The JVM says, “you can't 
teach an old Dog new code." 


Using the serialVersionVID 


Each time an object is serialized, the object (including every 
object in its graph) is “stamped” with a version ID number 
for the object’s class. The ID is called the serial VersionUID, 
and it’s computed based on information about the class 
structure. As an object is being deserialized, if the class has 
changed since the object was serialized, the class could have 
a different serialVersionUID, and deserialization will fail! 
But you can control this. 


If you think there is ANY possibility that 
your class might evolve, put a serial version 
ID in your class. 


When Java tries to deserialize an object, it compares the 
serialized object’s serialVersionUID with that of the class 
the JVM is using for deserializing the object. For example, 
if a Dog instance was serialized with an ID of, say 23 

(in reality a serialVersionUID is much longer), when the 
JVM deserializes the Dog object, it will first compare 

the Dog object serial VersionUID with the Dog class 
serialVersionUID. If the two numbers don’t match, the 
JVM assumes the class is not compatible with the previously 
serialized object, and you'll get an exception during 
deserialization. 


So, the solution is to put a serialVersionUID in your class, 
and then as the class evolves, the serialVersionUID will 
remain the same and the JVM will say, “OK, cool, the class 
is compatible with this serialized object,” even though the 
class has actually changed. 


This works only if you’re careful with your class changes! In 
other words, you are taking responsibility for any issues that 
come up when an older object is brought back to life with a 
newer class. 


To get a serialVersionUID for a class, use the serialver tool 
that ships with your Java development kit. 


File Edit Window Help serialKiller 


Q 


% serialver Dog 


Dog: static final long 
serialVersionUID = 
-5849794470654667210L; 
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When you think your class 
might evolve after someone has 
serialized objects from it... 


@) Use the serialver command-line tool 
to get the version ID for your class. 


File Edit Window Help serialKiller 


° 


% serialver Dog 


Dog: static final long 


serialVersionuID = 
-5849794470654667210L; 


KR Based on the version of 


Java you're using, this value 
might be different. 


@ Paste the output into your class. 
public class Dog { 


static final long serialVersionUID = 
-5849794470654667210L; 


private String name; 
private int size; 


// method code here 


GB) Be sure that when you make changes to 
the class, you take responsibility in your 
code for the consequences of the changes 
you made to the class! For example, be 
sure that your new Dog class can deal with 
an old Dog being deserialized with default 
values for instance variables added to the 
class after the Dog was serialized. 
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Object Serialization 


BULLET POINTS 


You can save an object's state by serializing the object. 

To serialize an object, you need an ObjectOutputStream (from the java.io 
package). 

Streams are either connection streams or chain streams. 


Connection streams can represent a connection to a source or 
destination, typically a file, network socket connection, or the console. 


Chain streams cannot connect to a source or destination and must be 
chained to a connection (or other) stream. 


To serialize an object to a file, make a FileOutputStream and chain it into 
an ObjectOutputStream. 


To serialize an object, call writeObject(theObject) on the 
ObjectOutputStream. You do not need to call methods on the 
FileOutputStream. 


To be serialized, an object must implement the Serializable interface. 
If a superclass of the class implements Serializable, the subclass will 
automatically be serializable even if it does not specifically declare 
implements Serializable. 


When an object is serialized, its entire object graph is serialized. That 
means any objects referenced by the serialized object’s instance 
variables are serialized, and any objects referenced by those objects... 
and so on. 


If any object in the graph is not serializable, an exception will be thrown at 
runtime, unless the instance variable referring to the object is skipped. 


Mark an instance variable with the transient keyword if you want 
serialization to skip that variable. The variable will be restored as null (for 
object references) or default values (for primitives). 


During deserialization, the class of all objects in the graph must be 
available to the JVM. 


You read objects in (using readObject()) in the order in which they were 
originally written. 


The return type of readObject() is type Object, so deserialized objects 
must be cast to their real type. 


Static variables are not serialized! It doesn’t make sense to save a static 
variable value as part of a specific object’s state, since all objects of that 
type share only a single value—the one in the class. 

If a class that implements Serializable might change over time, put a 
static final long serialVersionUID on that class. This version ID should be 
changed when the serialized variables in that class change. 


Writing a String to a Text File 


Saving objects, through serialization, is the easiest way to save and restore 
data between runnings of a Java program. But sometimes you need to save 
data to a plain old text file. Imagine your Java program has to write data to 


a simple text file that some other (perhaps non-Java) program needs to read. 


You might, for example, have a servlet (Java code running within your web 
server) that takes form data the user typed into a browser and writes it to a 
text file that somebody else loads into a spreadsheet for analysis. 


Writing text data (a String, actually) is similar to writing an object, except 
you write a String instead of an object, and you use something like a 
FileWriter instead of a FileOutputStream (and you don’t chain it to an 
ObjectOutputStream). 


To write a serialized object: 
objectOutputStream.writeObject (someObject) ; 


To write a String: 
fileWriter.write("My first String to save"); 


€ We need the java" i 
import Jjava.io.*; 
class WriteAFile { 


public static void main(String[] args) { 


try { 


writer.close(); Close an 
} catch (IOException ex) { 
ex.printStackTrace () ; 


ackage for 


writer.write("hello foo!"); <—~— qT 
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What the game character data 
might look like if You wrote it 
out as a human-readable text file. 


50,Elf,bow,sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 


FileWeiter: 


» does now 


\f the See mall eveate 


exists 


~ FileWriter writer = new FileWriter ("Foo.txt") ; 


feat method takes 


ring. 


you're done! 
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Text file example: e-Flasheards 


Remember those flashcards you used in school? Where you 
had a question on one side and the answer on the back? They 
aren't much help when you’re trying to understand something, 
but nothing beats ’em for raw drill-and-practice and rote 
memorization. When you have to burn in a fact. And they’re also 
great for trivia games. 


We’re going to make an electronic version that has 
three classes: 


1. QuizCardBuilder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 


2. QuizCardPlayer, a playback engine that can load a 


flashcard set and play it for the user. QuizCard 
3. QuizCard, a simple class representing card data. We'll walk QuizCard(q, a) 
through the code for the builder and the player, and have you 
make the QuizCard class yourself, using this: ————————>_ | question 
answer 
getQuestion() 
eee Quiz Card Builder getAnswer() 
File 
Question: 
Which university is featured in the 
film "Good Will Hunting"? eee Quiz Card Player 


File 


Which university is featured in the 
film "Good Will Hunting"? 


Answer: 


M.LT, 


Next Card 


Show Answer 


| eS 


QuizCardBuilder QuizCardPlayer 
Has a File menu with a “Save” option for saving Has a File menu with a “Load" option for loading a 
the current set of cards to a text file. set of cards from a text file. 
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Quiz Card Builder (code outline) 


public class QuizCardBuilder { 
public void go() { Builds and displays the 
// build and display gui makin, and registering € 


GUI, including 


vent listeners: 


} 


private void nextCard() { Call when user hits ange page aie 
// add the current card to the list means the user wants oe 
// and clear the text areas the list and start a new 
} 
private void saveCard() { Call when us ‘en 
// bring up a file dialog box means the oo from the File menu; 
// let the user name and save the set Current list as 3 ‘set? (like me the ¢ards in the 
Hollywood Trivia, Java Rules, corse” Mechanies Set, 


private void clearCard() { 
// clear out the text areas 


Will need to elea 
ooses ‘Ney,’ fro 
} € next eard, 


v the SCreey, when th user 
: ie e 
a) the } ile menu bod moves 


private void saveFile(File file) { 
// iterate through the list of cards and write 
// each one out to a text file in a parseable way 
// (in other words, with clear separations between parts) 


Called by the SaveMenuListener; 
does the actual File writing. 


Java 1/0 to NIO to NIO.2 


The Java API has included I/O features since day one, you know, back in the last millennium. In 2002, 
Java 1.4 was released, and it included a new approach to I/O called “NIO,” short for non-blocking I/O. In 
2011, Java 7 was released, and it included big enhancements to NIO. This yet again newer approach to 
I/O was dubbed “NIO.2.”Why should you care? When you're writing new I/O, you should use the latest 


and greatest features. But you're almost certainly going to encounter older code that uses the NIO ap- 
proach. We want you to be covered for both situations, so in this chapter: 


+ We'll use original I/O for a while. 
+ — Then we'll show some NIO.2. 


You'll see more I/O, NIO, and NIO.2 features in Chapter 17, Make a Connection, when we look at network 
connections. 
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Quiz Card Builder code 


import 
import 
import 
import 


javax.swing.*; 
java.awt.*; 
java.io.*; 
java.util.ArrayList; 


public class QuizCardBuilder { 
private ArrayList<QuizCard> cardList = 


private JTextArea question; 
private JTextArea answer; 
private JFrame frame; 


public static void main(String[] 
new QuizCardBuilder().go(); 


args) { 


public void go() { 
frame = new JFrame("Quiz Card Builder"); 
JPanel mainPanel = new JPanel (); 
Font bigFont = new Font ("sanserif", 


Font.BOLD, 


question = createTextArea (bigFont) ; 

JScrollPane qScroller = createScroller (question) ; 
answer = createTextArea (bigFont) ; 

JScrollPane aScroller = createScroller (answer) ; 


mainPanel.add(new JLabel ("Question:")); 
mainPanel.add(qScroller) ; 
( 
( 


mainPanel.add(new JLabel ("Answer:")); 
mainPanel.add(aScroller) ; 


JButton nextButton = new JButton ("Next Card"); 
nextButton.addActionListener(e -> nextCard()); 
mainPanel.add(nextButton); 


JMenuBar menuBar = new JMenuBar() ; 
JMenu fileMenu = new JMenu ("File") ; 


JMenuIltem newMenuItem = new JMenultem("New") ; 
newMenultem.addActionListener(e -> clearAll()); 


JMenultem saveMenuItem = new JMenulItem("Save") ; 
saveMenultem.addActionListener(e -> saveCard()); 


fileMenu. add (newMenultem) ; 
fileMenu. add (saveMenultem) ; 
menuBar. add (fileMenu) ; 
frame.setJMenuBar (menuBar) ; 


frame.getContentPan 
frame.setSize(500, 600); 
frame.setVisible (true) ; 
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24); 


() .add(BorderLayout.CENTER, mainPanel); 


Reminder: For the next eight 
pages or so we'll be using 


new ArrayList<>(); 


older-style 1/0 code! 
This is g 6U| 
; Code h ; 
Five aftha y) si might othin 
[2k 2 the colle (ON et 
and Menultens MenuBar, Menu, 


h 
Next Card putton calls eo pressed 


ext Card method when t 
Ww 


. W » 
When the user tlicks “New on 


the menu, the tlearAll method 
is called. 
When the user ¢]; 
clicks “Coy.” 
tHE menu, the a a atte 
Is Called. muled 
We make am 
enu bar, mak 
=. ~ ‘ies t ‘New’ an ice 
= gus iar the File menu We 
: 
and then tell the t bars 
'S menu bar Ine : ey 
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private JScrollPane createScroller (JTextArea textArea) { 
JScrollPane scroller = new JScrollPane(textArea) ; 
scroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTICAL SCROLLBAR ALWAYS) ; 
scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants.HORIZONTAL SCROLLBAR NEVER) ; 
return scroller; 


private JTextArea createTextArea(Font font) { 
JTextArea textArea = new JTextArea(6, 20); 
textArea.setLineWrap (true) ; 
textArea.setWrapStyleWord (true) ; 
textArea.setFont (font); 
return textArea; 


private void nextCard() { 
QuizCard card = new QuizCard(question.getText(), answer.getText()); 
cardList.add(card) ; 
clearCard(); 


private void saveCard() { 
QuizCard card = new QuizCard(question.getText(), answer.getText()); 


: Anis 
cardList.add(card) ; bor 3 av ae 
| Lile dialog, « ‘Save Seom the 

JFileChooser fileSave = new JFileChooser(); Bring . : mn ar 


fileSave.showSaveDialog (frame) ; 


: th: 
saveFile (fileSave.getSelectedFile()); ——————— dial me 3 tile, eth {his easy: 
} selecuind el te ally s 
JFileChoo 
private void clearAll() { 
cardList.clear(); When we want a new set of the 
clearCard(); tards, We need to clear ou 7 
} tard list AND the text areas: 
private void clearCard() { h actual file win. 

; t does } wt, ha 
question.setText (""); h method tha uListener $ ve as SONNY) 
answer.setText (""); The by the Caveat. brett the vse 
question.requestFocus () ; (called Y 4 is he Fil ) the next page 

} : ‘ The ee bh File class on 
We'll \oo We chain a BufferedW¢j 


| | ere. FileWriter titer on to a new 
private void saveFile(File file) { LO ( to make writing more efficient. 


We ’ 

— ell talk about that in a few pages.) 
BufferedWriter writer = new BufferedWriter (new FileWriter (file) ); ‘i 
for (QuizCard card : cardList) { W: 

falk 
writer.write (card.getQuestion() + "/"); each the ArrayList of tards and 
writer.write(card.getAnswer() + "\n"); questi a. » One Card Per line, with th 
on and a e 
} nswer separated b wp 
: a/ 
writer.close(); en add a newline Character ey, aie 

} catch (IOException e) { : 

System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 
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14 java.io.File Aete 


The java.io.File class is another example of an older class in the 
Java API. It’s been “replaced” by two classes in the newer 
java.nio.file package, but you’ll undoubtedly encounter code 
that uses the File class. For new code, we recommend using 
the java .nio.file package instead of the java.io.File 
class. In a few pages, we’ll take a look at a few of the most important 
capabilities in the java.nio.file package. With that said... 


The java.io.File class represents a file on disk but doesn’t actually 
represent the contents of the file. What? Think of a File object as 
something more like a path name of a file (or even a directory) rather 
than The Actual File Itself! The File class does not, for example, have 
methods for reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a file than just 
using a String filename. For example, most classes that take a String 
filename in their constructor (like FileWriter or FileInputStream) 

can take a File object instead. You can construct a File object, verify 
that you've got a valid path, etc., and then give that File object to the 
FileWriter or FileInputStream. 


Some things you can do with a File object: 


@ Make a File object representing an 
existing file 
File f = new File ("MyCode.txt") ; 


@ Make a new directory 
File dir = new File("Chapter7") ; 
dir.mkdir () ; 


© List the contents of a directory 
if (dir.isDirectory()) { 
String[] dirContents = dir.list(); 
for (String dirContent : dirContents) { 
System.out.println(dirContent) ; 
} 
} 


@ Delete a file or directory (returns true if 
successful) 


boolean isDeleted = f.delete(); 
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ig 
Sheery Darcis = 


7360 Foo Drive 


A File object represents the 
name and path of a file or 
directory on disk, for example: 


/Users/Kathy/Data/Game.txt 


But it does NOT represent, or 
give you access to, the data in 
the file! 


An address 1s NOT the 
same aS the aioe 


| h File o ect is 
ae street ene 


Fort Hueneme ,cA it represents fhe name 
__————— and lotation t 
: seid file, bok ' 

isnt the file itse 
the 
+ e' resents 
f feed “ei leet” 
GameFile.txt 


50,EIf,bow, sword,dust 
200,Troll,bare hands,big ax 
120,Magician,spells,invisibility 


~ 
A File 


represen 
diet access 


data wside the ue 


serialization and file I/O 


The beauty of buffers 


If there were no buffers, it would be like 
shopping without a cart. You'd have to 
carry each thing out to your car, one soup 
can or toilet paper roll at a time. 


\\ 
A 


AU UUIEBIINET 2 ‘it Buffers 9: 
NN Nt filace i ute Lat temporary holdin 
per Se as i as 
* You 


ar tewe, trips whe make 


Nn You use 9 bu ther. 


String is put into a buffer When the buffer is full, the 


Aspen 
with other Strings Strings are all written to 


Denver 


“Boulder” _____»| Boulder 
is written to 
String 


BufferedWriter FileWriter 


(a chain stream that (a connection stream 
works with characters) 


File 


that writes characters 
as opposed to bytes) 


BufferedWriter writer = new BufferedWriter (new FileWriter (aFile) ) ; No Lie th A 
1C€ that we dop’ 
need to kee ont even 
a 
the Fileweit, reference to 


Using buffers is much more efficient than working without them. You can write to 


a file using FileWriter alone, by calling write(someString), but FileWriter writes B. i ning we Care about is the 
each and every thing you pass to the file each and every time. That’s overhead the ob; eet oT because that’s 
you don’t want or need, since every trip to the disk is a Big Deal compared to on, a es e I methods 
manipulating data in memory. By chaining a BufferedWriter onto a File Writer, the Buffere dWej re Close the 
BufferedWriter will hold all the stuff you write to it until it’s full. Only when the buffer ave of the nea of will take 

as full will the FileWriter actually be told to write to the file on disk. the chain. 


If you do want to send data before the buffer is full, you do have control. 
Just Flush ft. Calls to writer.flush() say, “send whatever’s in the buffer, noz!” 
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Reading froma text file 


Reading text from a file is simple, but this time we'll use a File object 
to represent the file, a FileReader to do the actual reading, and a 
BufferedReader to make the reading more efficient. What's 2 + 22/4 


What’s 20+22/42 


The read happens by reading lines in a while loop, ending the loop when 
the result of a readLine() is null. That’s the most common style for 
reading data (pretty much anything that’s not a Serialized object): read 
stuff in a while loop (actually a while loop ées?), terminating when there’s 
nothing left to read (which we know because the result of whatever read 
method we’re using 1s null). 


import java.io.*; 


A file with two lines of text. 


mde £ Loroet the import: 


: MyText.txt 
class ReadAFile { 
public static void main(String[] args) { A FileReader is a Connection stream for 
phic characters that Connects to a text file. 


Make a S 


File myFile = new File("MyText.txt") ; 
FileReader fileReader = new FileReader (myFile) ; 


BufferedReader reader = new BufferedReader (fileReader) ; 3 


; der to 
Lving variable vee Crain the hee mare 
B 


oe is ved edReader \\ Qo back 
each lime 3s the ling '* a eaainy get wien the 
String line; Lhe file vet ebause {ne rs 
while ((line = reader.readLine()) != null) { pucker 1 a everyUning ™ 
System. out.println (line) ; program has 
} This says, “Read a | 
reader .close () ; String variable “ine He Fel a assign it to the 
' ecause there WAS somebhc. . variable is not nul 

} catch (IOException e) { ine that was just read” 9 ©? "€8Q) print out the 
e.printStackTrace() ; Or another ; 

} to read ea as Saying it, “While there ar, still |; 

} 4 em and Print them.” € still lines 
} 
Java 8 Streams and I/0 

If you're using Java 8 and you feel comfortable using the Streams API, 

you can replace all the code inside the try block with the following: 
Files .lines (Path.of ("MyText.txt") ) 

.forEach (line -> System.out.printlin (line) ) ; 
We'll see the Files and Path classes later in this chapter. 
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Quiz Card Player (code outline) 


public class QuizCardPlayer { 


public void go() { 
// build and display gui 
} 


private void nextCard() { 
// if this is a question, show the answer, otherwise show 
// next question set a flag for whether we’re viewing a 
// question or answer 


private void open() { 
// bring up a file dialog box 
// let the user navigate to and choose a card set to open 


private void loadFile(File file) { 
// must build an ArrayList of cards, by reading them from 
// a text file called from the OpenMenuListener event handler, 
// veads the file one line at a time and tells the makeCard() 
// method to make a new card out of the line (one line in the 
// file holds both the question and answer, separated by a “/”) 


private void makeCard(String lineToParse) { 
// called by the loadFile method, takes a line from the text file 
// and parses into two pieces—question and answer—and creates a 
// new QuizCard and adds it to the ArrayList called CardList 
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Quiz Card Player code 


import javax.swing.*; 
import java.awt.*; 

import java.io.*; 

import java.util.ArrayList; 


public class QuizCardPlayer { 
private ArrayList<QuizCard> cardList; 
private int currentCardIndex; 
private QuizCard currentCard; 
private JTextArea display; 
private JFrame frame; 
private JButton nextButton; 
private boolean isShowAnswer; 


public static void main(String[] args) { 
QuizCardPlayer reader = new QuizCardPlayer(); 


reader.go(); 


public void go() { 
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frame = new JFrame("Quiz Card Player"); 
JPanel mainPanel = new JPanel (); 


Just GU/ Code on 
nothing Special. 


Font bigFont = new Font("sanserif", Font.BOLD, 24); 


display = new JTextArea(10, 20); 
display.setFont (bigFont) ; 
display.setLineWrap (true) ; 
display.setEditable (false); 


JScrollPane scroller = new JScrollPane (display) ; 


scroller.setVerticalScrollBarPolicy(ScrollPaneConstants.V 
scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants.HORIZONTAL SCROLLBAR_N 


mainPanel.add(scroller); 


nextButton = new JButton("Show Question") ; 


, 


this Page; 


nextButton.addActionListener(e -> nextCard()); 


mainPanel.add(nextButton); 


JMenuBar menuBar = new JMenuBar(); 
JMenu fileMenu = new JMenu ("File") ; 


JMenuItem loadMenuItem = new JMenuItem("Load card set"); 


loadMenuItem.addActionListener(e -> open ( 
fileMenu. add(loadMenuItem) ; 
menuBar. add (fileMenu) ; 

frame.setJMenuBar (menuBar) ; 


frame.getContentPane().add(BorderLayout.C 
frame.setSize(500, 400); 
frame.setVisible (true) ; 
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private void nextCard() { 
if (isShowAnswer) { 
// show the answer because they’ve seen the question 
display.setText (currentCard.getAnswer()); 


nextButton.setText ("Next Card"); Cheek the isShow 
isShowAnswer = false; . see if they're pea boolean flag is 
} else { // show the next question OF an answer, and ently viewing a question 
if (currentCardIndex < cardList.size()) { thing dependiy nd do the appropriate 
showNextCard () ; 'n9 on the answer. 
} else f{ 


// there are no more cards! 
display.setText ("That was last card"); 
nextButton.setEnabled(false) ; 


private void open() { & let them 
JFileChooser fileOpen = new JFileChooser();—_ | the file dialog bor 20 bo oper 
fileOpen. showOpenDialog (frame) ; Bring i to and choose the +He 
loadFile (fileOpen.getSelectedFile()); navigate 
} Ny ined 
haine 
dReader ¢ 
ea Buffere «ig the 
private void loadFile(File file) { Mak wy FileReaders gv" : user 
cardList = new ArrayList<>(); eReader the File one autos 
currentCardIndex = 0; Ae from the open ve 
try { 
BufferedReader reader = new BufferedReader (new FileReader (file) ); ee 
String line; : ka Lind) passin the ee 
while ((line = reader.readLine()) != null) { Read a line () method tha yarser | 
makeCard (line) ; the makeCard m5 veal QuizCard and 
} and turns 1 IP List. 
: a 
reader.close(); adds it to the fray 
} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 


} 


. Now time to start 
howNextCard(); 4— 
} on show the first card. 


private void makeCard(String lineToParse) { Each line of text corresponds to rate 
String[] result = lineToParse.split("/"); ——— Llasheard, but we have to parse ou e 


QuizCard card = new QuizCard(result[0], result[1]); question and answer as separate pieces. We 


cardList.add(card) ; use the Strin split) method to break the 
System.out.printin("made a card"); els | aries (oe for ie sere 
and one for the answer). We'll look at the 


split() method on the next page: 
private void showNextCard() { 
currentCard = cardList.get (currentCardIndex) ; 
currentCardIndext+; 
display.setText (currentCard.getQuestion()); 
nextButton.setText ("Show Answer"); 
isShowAnswer = true; 
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Parsing with String split() 


Imagine you have a flashcard like this: Saved Ine question tle Mke-tnls: 


Question What is blue + yellow?/green 
What is red + blue?/purple 


What is blue + yellow? 


Answer 


How do you separate the question and answer? 


When you read the file, the question and answer are smooshed 
together in one line, separated by a forward slash "/" (because 
that's how we wrote the file in the QuizCardBuilder code). 


String split() lets you break a String into pieces. 


The split() method says, “give me a separator, and I'll break out all 
the pieces of this String for you and put them ina String array." 


0 Ge» 


token 1 separator token 2 


. gpp, this is 
ln the Guinea aT ke when 


hat a single | 
— os read KG from the file. 


String toTest = "What is blue + yellow?/green"; The split) method tak 
metho es 


th by Aad 7 
String[] result = toTest.split("/") ; ae aie ih bus rie iG pes ig 
S, toKen I and token 2. (N, 


for (String token : result) { see powerful than what ae va 
F : can do extremel Comp] : ; : ere. 
System.out.println (token) ; oat wildéseds-cts 3 Y Complex parsing with Filters, 
oop hrough the arr, , : 
‘ ‘a : 
} IN pee In this example, ha = each token 
ens: What is blue + yell owe 7 only two 


and ‘Green.” 
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Dumb Questions 


Q: OK, | look in the API and there are about five 
million classes in the java.io package. How the heck do 
you know which ones to use? 


A: The I/O API uses the modular “chaining” concept so 
that you can hook together connection streams and chain 
streams (also called “filter” streams) in a wide range of 
combinations to get just about anything you could want. 


The chains don’t have to stop at two levels; you can hook 
multiple chain streams to one another to get just the right 
amount of processing you need. 


Most of the time, though, you'll use the same 

small handful of classes. If you're writing text files, 
BufferedReader and BufferedWriter (chained to FileReader 
and FileWriter) are probably all you need. If you're writing 
serialized objects, you can use ObjectOutputStream and 
ObjectInputStream (chained to FilelnputStream and 
FileOutputStream). 


In other words, 90% of what you might typically do with 
Java I/O can use what we've already covered. 


Q: You just said we've already learned 90% of what 
we'll probably use, but we haven't seen the fabled NIO.2 
stuff yet. What gives? 


A: NIO.2 is coming up on the very next page! But 

for reading and writing text files, BufferedReaders and 
BufferedWriters are still usually the way to go. So we'll be 
looking at how NIO.2 makes using them easier. 


Q: My brain is a little tired, and I’ve heard NIO.2 is 
pretty complicated. 


A: We're going to focus on a few key concepts in the 
java.nio.file package. 


Make it Stick 


Roses are first, violets 


Readers and 


-—— BULLET POINTS 
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Java is 
Pass 
by value 


Wash | 
threads Cat 
wait 
notify 


are next. 


Writers are only for text. 


To write a text file, start with a FileWriter 
connection stream. 


Chain the FileWriter to a BufferedWriter for 
efficiency. 

A File object represents a file at a particular 
path, but does not represent the actual 
contents of the file. 


With a File object you can create, traverse, 
and delete directories. 


Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 


To read a text file, start with a FileReader 
connection stream. 


Chain the FileReader to a BufferedReader for 
efficiency. 

To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some kind of character to separate the 
individual pieces. 

Use the String split() method to split a String 
up into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesn’t 
count as a token. 
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NIO.2 and the[ENeMatny package 


Java NIO.2 is usually taken to mean two packages added in Java 7: 


java.nio.file A Path object represents 
the location (name and 
path) of a file or directory 
The java.nio.file.attribute package lets you manipulate the on disk, for example: 
metadata associated with a computer’s files and directories. For example, you 


java.nio.file.attribute 


/Users/Kathy/Data/Game.txt 


would use the classes in this package if you wanted to read or change a file’s 
permissions settings. We WON’T be discussing this package further. (phew) But it does NOT represent, 
or give you access to, the 


The java.nio.file package is all you need to do common text file data in the file! 


reading and writing, and it also provides you with the ability to manipulate 
a computer’s directories and directory structure. Most of the time you'll use 
three types in java.nio.file: 


" The Path interface: You'll always need a Path object to locate the 
directories or files you want to work with. 


™ The Paths class: You’ll use the Paths.get() method to make the Path object An advanced but 
you'll need when you use methods in the Files class. useful capability 
® The Files class: This is the class whose (static) methods do all the in the Files class 
work you'll want to do: making new Readers and Writers, and creating, 4 
modifying, and searching through directories and files on file systems. allows you to ‘walk 
» 

thru” (search) 

A mini-tutorial, creating a BufferedWriter with NIO.2 directory trees. 


@ Import Path, Paths, and Files: 
import java.nio.file.*; 


j i f mputer 
A Path object is used to locate a File on a Compu 
@ Make a Path object using the Paths a Gece ie Tile system). A path ean Ee wide lobe 


Alana: Liles in the current directory or in other directories. 


Path myPath = Paths.get("MyFile.txt") ; 


The “7” in “/myApp” is called the 


Or, if the file is in a subdirectory like: Pi da ictead epending on which 
/my App/files/MyFile.txt : ene usingy Your name—separator 
mig e different; ‘or example, it 
Path myPath = Paths.get("/myApp", "files", "MyFile.txt") ; might be “\”. 
@® Make a new BufferedWriter using a Path and Somewhere—under the Covers—some 
the Files class: method is saying; 
BufferedWriter writer = Files .newBufferedWriter (myPath) ; BufferedWriter writer = 


new BufferedWriter(..) 
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Path, Paths, and Files (messing with directories) 


In Appendix B, we'll be discussing how to split your Java app into packages. This includes creating the 
proper directory structure for all of your app’s files. In most cases you’ll make and move directories and 
files by hand, using the command line or utilities like the Finder or Windows Explorer. But you can also 
do it from within your Java code. 


Warning! Goofing around with directories in a Java program is a real “can of worms” topic. To do it 
correctly you need to learn about paths, absolute paths, relative paths, OS permissions, file attributes, 
and on and on. Below is a greatly simplified example of messing around with directories, just to give you 
a feel for what’s possible. 


Suppose you wanted to make an installer program to install your killer app. You start with the directory 
and files on the left, and want to end up with the directory structure and files on the right. 


Run the Install 


tlass From here: 


Media for the 
apy lands here: 


Comvil ed tode 
lands here: 


iure eugue I 
tat vero 


conse 


eugueroLore 
do eliquis 
do del dip 


1001010101 


Install.class  MyApp.class © MyMediajpeg 


1001010101 


import java.nio.file.*; 
public class Install { 
public static void main(String[] args) { 
try { 
Path myPath = Paths.get ("MyApp") ; 
Path myPath2 = Paths.get("MyApp", "media") ; 
Path myPath3 = Paths.get("MyApp", "source") ; Create all the 
( 


eugueroLore 


do eliquis 
do del dip 


1001010101 


MyApp.class MyMedia.jpeg 


Path mySource = Paths.get ("MyApp.class"); Path locations: 
Path myMedia = Paths.get("MyMedia. jpeg") ; 


Create the three 


: " _ : : 
Files.createDirectory(myPath) ; ah directories: 


Files.createDirectory (myPath2) ; Lo 

Files.createDirectory(myPath3) ; Move the two 

Files.move (mySource, myPath3.resolve (mySource.getFileName())); Liles into theiw 

Files.move(myMedia, myPath2.resolve (myMedia.getFileName())); new divectories 
} catch (Exception e) { 

System.out.printin("Got an NIO Exception" + e.getMessage()); 
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Finally, a closer look at finally 


Several chapters ago we looked at how try-catch-finally worked. Kind of. All we 
said about finally was that it was a good place to put your “cleanup code.” That’s 
true, but let’s get more specific. Most of the time, when we talk about “cleanup 
code,” we mean closing resources we borrowed from the operating system. When 
we open a file or a socket, the OS is giving us some of its resources. When we’re 
done with them, we need to give them back. Below is a snippet of code from the 
QuizCardBuilder class. We highlighted a call to a constructor and three separate 
method calls... 


That’s FOUR places an exception can be thrown! 


private void saveFile(File file) { 
try { 
BufferedWriter writer = new BufferedWriter (new FileWriter (file) ) ; 
for (QuizCard card : cardList) { 
writer.write (card.getQuestion() + "/"); 


writer.write (card.getAnswer() + "\n"); All the places an exception 
} tould be thrown! 
writer.close() ; 
} catch (IOException —————— 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 


} 


If the call to make a new FileWriter fails, if ANY of the many write() invocations 
fail, or the close() itself fails, an exception will be thrown, the JVM will jump to 
the catch block, and the writer will never be closed. Yikes! 


Remember, finally ALWAYS runs!! 


Since we REALLY want to make sure we close the writer file, let’s put the close() 
invocation in a finally block. 


i your pencil Coding the new finally block 


What changes will we have to make to the code 
above to move the close() to a finally block? 


> Yours to solve. There might be more than you first imagine. 
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Finally, a closer look at finally, cont. 


The amount of code required to put the close() in the finally block might surprise 
you; let’s take a look. 


private void saveFile(File file) { We had to declare the writer 
BufferedWriter writer = null; e——_~ reference outside of the try 
try { block so that it’s visible in 

writer = new BufferedWriter (new FileWriter (file) ) ; the Finally block. 

for (QuizCard card : cardList) { 
writer.write (card.getQuestion() + "/"); 
writer.write (card.getAnswer() + "\n"); 

} 

writer.close(); 

catch (IOException e) { 

System.out.printin("Couldn't write the cardList out: 

finally { 

Ey 
writer.close(); 

} catch (Exception e) { 
System.out.printin("Couldn't close writer: 


} 
} 
ae Yup, we had to put the ¢lose() in 
yet another try—cateh block! 


Are you kidding me right now? 
T have to write all of this code 
every time I want to do a little 
I/O? Verbose much? 


~ 


"+ e.getMessage()); 


=i 


" + e.getMessage()); 


There IS a better way! 


In the early days of Java, this is how you had to make sure you 
were really closing a file. You are very likely to encounter finally 
blocks that look like this when you’re looking at existing code. But 
for new code, there is a better way: 


Try-With-Resources 


We'll look at that next. 
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The try-with-resources (TWR), statement 


If you’re using Java 7 or later (and we sure hope you are!), you can use the 
try-with-resources version of try statements to make doing I/O easier. Let’s 
compare the try code we’ve been looking at with try-with-resources code that 


does the same thing: 


private void saveFile(File file) { 
BufferedWriter writer = null; Old style, 


try { ‘he try—cateh-finally 


writer = new BufferedWriter(new FileWriter (fil 


code 
for (QuizCard card : cardList) { 
writer.write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 
} 
} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 
} finally { 
try { 
writer.close(); 
} catch (Exception e) { 
System.out.printin("Couldn't close writer: " + e.getMessage()); 


} 


} 


private void saveFile (File file) { 
try (BufferedWriter writer = Modern, 


new BufferedWriter(new FileWriter (file))) { { th t 
rY—with—resources 
on 


for (QuizCard card : cardList) { 
writer.write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 


} 


} catch (IOException e) { 
System.out.printin("Couldn't write the cardList out: " + e.getMessage()); 
} 
} 
thereyare_no 


Dumb Questions 


: Wait, what? You told us that a try statement needs a catch 
and/or a finally? 


A: Nice catch! It turns out that when you use try-with-resources, 
the compiler makes a finally block for you. You can't see it, but it’s 


there. 
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Autocloseable, the very small catch 


On the last page we saw a different kind of try statement, the try-with-resources 
statement (TWR). Let’s take a look at how to write and use TWR statements by 


first, deconstructing the following: ONLY classes 


try (BufferedWriter writer = 


that implement 


new BufferedWriter (new FileWriter(file))) { Autocloseable ean. 


be used in TWR 


Writing a try-with-resources statement 
statements! 


@ Add a set of parentheses between “try” and “{": 


try (eee) 4 
@ Inside the parentheses, declare an object Like all of the [/0 classes 
whose type implements Autocloseable: we've been using this Chapter, 
ee BufferedWriter implements 
try (BufferedWriter writer = Autocloseable. 
new BufferedWriter(new FileWriter(file))) { 


® Use the object you declared inside the try block 
(just like you always did): 


writer.write(card.getQuestion() + "/"); 
writer.write(card.getAnswer() + "\n"); 


Autocloseable, it’s everywhere you do 1/0 


Autocloseable is an interface that was added to java.lang in Java 7. Almost all of 
the I/O you're ever going to do uses classes that implement Autocloseable. You 
mostly won’t have to think about it. 


There are a few more things worth knowing about TWR statements: 
™ You can declare and use more than one I/O resource in a single TWR block: 


try (BufferedWriter writer = 
new BufferedWriter (new FileWriter (file) ); 
BufferedReader reader = 
new BufferedReader (new FileReader (file))) { 


Separate the resources 
using, semicolons, “;”. 


= If you declare more than one resource, they will be closed in the order 
OPPOSITE to which they were declared; i.e., first declared 1s last closed. 


= If you add catch or finally blocks, the system will handle multiple close() 
invocations gracefully. 
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Code Kitchen 


x 


* 


*« Code Kitchen 


¥ 


Low-mid Tom 


High Agogo 


Open Hi Conga | 


@e0@ Cyber BeatBox When You ae 
calieelt, the 
Bass Drum OF Start aces a eshte 
f r = wir en 
Closed Hi-Hat | mY &@ “at saved: 
OpenHi-Hat = || ff a a a @es 
Tempo Up 
Acoustic Snare ee 
Crash Cymbal Tempo Down 
Hand Clap e @e serializelt 
High Tom [ ee restore 
Hi Bongo s TS 
RitaGas L) “restore” loads the sav, d 
wate Pi U) en back in, and ts 
e 
Low Conga he checkboxes. 
Cowbell 
Vibraslap 
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Let’s make the BeatBox save and 
restore our favorite pattern. 


chapter 16 


serialization and file I/O 


Saving a BeatBox pattern 


Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it’s time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 beats. So 
to save a pattern, all we need to do is save the state of the checkboxes. 


We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things zm the array are 
serializable, so we'll have no trouble saving an array of booleans. 


To load a pattern back in, we read the single boolean array object (deserialize it) and 
restore the checkboxes. Most of the code you’ve already seen, in the Code Kitchen 
where we built the BeatBox GUL so in this chapter, we look at only the save and 
restore code. 


This GodeKitchen gets us ready for the next chapter, where instead of writing the 
pattern to a file, we send it over the network to the server. And instead of loading a 
pattern zm from a file, we get patterns from the server, each time a participant sends 
one to the server. 


i aac al aaa This is a method in the BeatBox code: We can 


i dd an 
is from a lambda expression when we a 
vor eeniiaile the sevializelt button, or create an 


. Is this. 
private void writeFile() { ActionListener inner class that calls thi 


boolean[] checkboxState = new boolean[256] ; — Make a boolean arra 


s 
for (int i = 0; i < 256; i++) { 
JCheckBox check = checkboxList.get (i) ; al iit the cheekboxL ist 
if (check.isSelected()) { the ayList of cheekboxes), get 
checkboxState[i] = true; rere be each one, and add it 
oolea 


n array. 


y to hold the 


€ each Checkbox. 


} 
} 


try (ObjectOutputStream os = 
new ObjectOutputStream(new FileOutputStream("Checkbox.ser"))) { Try 
os.writeObject (checkboxState) ; Thi ; 
} catch (IOException e) { : Part’s a Piece of cake. Just 
ee : write/seriali th ae 
.printStackTrace () ; Ze the one boolean array! 
} : 


wirth—vesour les 


} 


youarehere> 579 


deserializing the pattern 


Restoring a BeatBox pattern 


This is pretty much the save in reverse...read the boolean array and use it to restore 
the state of the GUI checkboxes. It all happens when the user hits the “restore” 
button. 


Restoring a pattern 
This is another method in the 
BeatBox class. 


private void readFile() { 
boolean[] checkboxState = null; 


try (ObjectInputStream is = ith—wesour CES 
new ObjectInputStream(new FileInputStream("Checkbox.ser"))) { Tyr" 
checkboxState = (boolean[]) is.readObject() ; <— 
} catch (Exception e) { head the Single ob; ; 
e.printStackTrace () ; oolean array) i a in the fil ¢ 
bool Y and Cast ; € (the 
} rep ca? array (remenb back to 3 
etur 3 er, : 
for (int i = 0; i < 256; it+) { mee Ve erence of 4 Ob it? 
= , , ject ) 


JCheckBox check = checkboxList.get (i) ; N 
check. setSelected (checkboxState[i]) ; ie aaa er aa él ras the 

} in the firrayLis é: 
JCheckBox objects lehcelhowtity 


sequencer.stop() ; 
uid idtira ckAndStart QO; Now stop whatever is currently playing, 
and rebuild the the using the new 


state of the checkboxes in the ArrayList. 


—» Yours to solve. 


G harpen your pencil 


IN This version has a huge limitation! When you hit the “serializelt” button, it 
serializes automatically, to a file named “Checkbox.ser” (which gets created if it 
doesn't exist). But each time you save, you overwrite the previously saved file. 


Improve the save and restore feature by incorporating a JFileChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously saved pattern files. 
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G harpen our pencil 
i) 


—+> Yours to solve. 


Object type 
Object 

String 

File 

Date 
OutputStream 
JFrame 
Integer 


System 


What's Legal? 


Circle the code fragments 
that would compile (assuming 
they're within a legal class). 


KEEP 


<= 
RIGHT 


—> Yours to solve. 
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Can they be saved? 


Which of these do you think are, or should be, 
serializable? If not, why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 


Serializable? If not, why not? 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


Yes / No 


FileReader fileReader = new FileReader() ; 
BufferedReader reader = new BufferedReader (fileReader) ; 


FileOutputStream f = new FileOutputStream("Foo.ser") ; 
ObjectOutputStream os = new ObjectOutputStream(f) ; 


BufferedReader reader = new BufferedReader (new FileReader (file) ) ; 
String line; 
while ((line = reader.readLine()) != null) { 

makeCard (line) ; 


} 


FileOutputStream f = new FileOutputStream("Game.ser") ; 
ObjectInputStream is = new ObjectInputStream(f) ; 
GameCharacter oneAgain = (GameCharacter) is.readObject() ; 
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exercise: True or False 


This chapter explored the wonderful world 
of Java I/O. Your job is to decide whether 
each of the following |/O-related statements 
is true or false. 


2 TRve or Farse@ 


1. Serialization is appropriate when saving data for non-Java programs to use. 
2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serializable objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default. 

7. The java.nio.file.Path class can be used to locate files. 

8. If a superclass 1s not serializable, then the subclass can’t be serializable. 

9. Only classes that implement AutoCloseable can be used in try-with-resources statements. 
10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text file can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. File objects represent files, but not directories. 

14. You can’t force a buffer to send its data before it’s full. 

15. Both file readers and file writers can optionally be buffered. 

16. The methods on the Files class let you operate on files and directories. 


17. ‘Try-with-resources statements cannot include explicit finally blocks. 


—————> Answers on page 584. 
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Code Magnets 


This one’s tricky, so we promoted it from an Exercise to full Puzzle status. 
Reconstruct the code snippets to make a working Java program that pro- 
duces the output listed below. (You might not need all of the magnets, and 
you may reuse a magnet more than once.) 


2x | 


D 


nGame implements Serializable { 


class Dungeo 


putStream fos = new 


eam("dg.ser")# 


FileOut 


Short getz() { 


i cstr 
FileOutpu ae 


e.printStackTrace ( 
— 


ObjectInputStream ois = new 


int getx ( 


object InputStream (fis) 7 
return x; 


System.out.printin(d.getX()t+td.getY()+d.getZ()); 


FileInputStream fis = new ublic int x 


FileInputStream("dg.ser"); Pansient lang y= 


rivate short z 


long getY() { 


cl 
ass DungeonTest { 


im ort 3 . 
i jJava.io.*; 


Exception e) 


return y7 


fFos.writeobject (d) 


{ 


d = (DungeonGame) ois.readObject(); 


coos .writedbject (d)i 


} args) t 


ObjectOutputStream oos = new 


File Edit Window Help Torture 


% java DungeonTest 
12 


ObjectOutputStream (fos); 


8 


public static void main (Stringl 


= new DungeonGame () ; 


DungeonGame da 


—————> Answers on page 585. youarehere> 583 


exercise solutions 


Exercise Solutions 
TRve or Fatse 
(from page 582) 
1. Serialization 1s appropriate when saving data for non-Java programs to use. False 
2. Object state can be saved only by using serialization. False 
3. ObjectOutputStream is a class used to save serializable objects. True 
4. Chain streams can be used on their own or with connection streams. False 
5. A single call to writeObject() can cause many objects to be saved. True 
6. All classes are serializable by default. False 
7. The java.nio.file.Path class can be used to locate files. False 
8. If a superclass 1s not serializable, then the subclass can’t be serializable. False 


9. Only classes that implement AutoCloseable can be used in try-with-resources statements. True 


10. When an object is deserialized, its constructor does not run. True 
11. Both serialization and saving to a text file can throw exceptions. True 
12. BufferedWriters can be chained to FileWriters. True 
13. File objects represent files, but not directories. False 
14. You can’t force a buffer to send its data before it’s full. False 
15. Both file readers and file writers can optionally be buffered. True 
16. The methods on the Files class let you operate on files and directories. True 
17. ‘Try-with-resources statements cannot include explicit finally blocks. False 
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Good thing we're 
finally at the answers. 
I was gettin’ kind of 

tired of this chapter. 


Code Magnets 


(from page 583) 


import java.io.*; 


class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 


ney “yy int getX() { 

: = ZA return x; 

} 

long getY() { 
return ¥; 

} 

short getZ() { 
return Z; 


class DungeonTest { 
public static void main(String[] args) { 

DungeonGame d = new DungeonGame () ; 

System.out.printlin(d.getX() + d.getY() + d.getZ()); 

try { 
FileOutputStream fos = new FileOutputStream("dg.ser") ; 
ObjectOutputStream oos = new ObjectOutputStream (fos) ; 
oos.writeObject (d) ; 
oos.close(); 


FileInputStream fis = new FileInputStream("dg.ser"); 
ObjectInputStream ois = new ObjectInputStreanm (fis) ; 
d = (DungeonGame) ois.readObject (); 
ois.close(); 

} catch (Exception e) { 

% java DungeonTest e.printStackTrace(); 

12 } 


System.out.printlin(d.getX() + d.getY() + d.getZ()); 


8 
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Make a Connection 


Connect with the outside world. Your Java program can talk to a program on 
another machine. It’s easy. All the low-level networking details are taken care of by the built- 
in Java libraries. One of Java's big benefits is that sending and receiving data over a network 
can be just I/O with a slightly different connection at the end of the I/O chain. In this chapter 
we'll connect to the outside world with channels. We'll make client channels. We'll make server 
channels. We'll make clients and servers, and we'll make them talk to each other. And we'll also 
have to learn how to do more than one thing at once. Before the chapter’s done, you'll have 

a fully functional, multithreaded chat client. Did we just say multithreaded? Yes, now you will 


learn the secret of how to talk to Bob while simultaneously listening to Suzy. 
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beatbox chat 


Real-time BeatBox chat 


You’re working on a computer game. You and your team are 
doing the sound design for each part of the game. Using a 
“chat” version of the BeatBox, your team can collaborate— 
you can send a beat pattern along with your chat message, 


and everybody in the BeatBox Chat gets 
it. So you don’t just get to ead the other 
participants’ messages; you get to load 
and play a beat pattern simply by clicking 
the message in the incoming messages 


area. 


In this chapter we’re going to learn what it 
takes to make a chat client like this. We’re 
even going to learn a little about making a 
chat server. We'll save the full BeatBox Chat 
for the Code Kitchen, but in this chapter 
you will write a Ludicrously Simple Chat 
Client and Very Simple Chat Server that 
send and receive text messages. 


You Can have Comp 
authentie, intelleetug 
stimulating chat 
Conversations. Ey, 


is sent to all Par 
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| = a z Cyber BeatBox le, 
Closed Hi-Hat iv] is a ( Stop} aa 
Open Hi-Hat a ane a r = 
| Acoustic Snare 7 : . = 
Crash Cymbal | 
| Hand Clap — 
High Tom | a Z 
= _ Sendit 
laracas : 
pe C try thi i 
on : : : . : 4 o He es One... it’s better for 
Low Conga 7 nas _ 
Cowbell} ; | | 
= . : or 3 message and 
os. send 
| Low-mid Tom Skylera: fast and or : ni oe 
High Agogo quence 12 oo AND 
Open Hi evster2: |j ‘ere 
i Conga OakenfolanejShY!2r2, but more t cent = 


Skyler5: you WISH! Too Perky 


eceived mes 


4 . a vi _ 
Clicking mn ern that wen 


loads the patt 
with it. 


nt 


e Chat Clie 
—achicken street? 


~~ Ludicrously simp! 


e how to get to Sesamm 


o kewl! 
WW it like that one 


more time, ri take my 
abused, 


DarkStar 
MuffinPerson 


Send your message to the server. 


- 
lly 


ery message 


ticipants. 


Chat program overview 


Each Client has to know 
about the Server. 


The Server has to know 
about ALL the Clients. 


How it works: 


1) Client connects to the server 


The server makes a 
connection and adds the client 
to the list of participants 


3) Another client connects 


Client A sends a message to 
the chat service 


@ The server distributes the 
message to ALL participants 
(including the original sender) 


networking and threads 


‘ello, I'm A chat 


Client A 


I'm just going 


to B myself Server 


Can you C 
me? 


Client B 


Client C 
| __ Server, |’d like to connect 
to the chat service. 


Client A Server 


—————__ 0K, you're in. 


Client A 


Server, I'd like to connect 
| — to the chat service. 


<< 0K, you're in. — 


Client B a 
|} __ ‘Who took the lava lamp 
from my dorm room?” 
Client A —_ 
«_—___ Who took the lava lamp 
yoy mY dorm room?” 
Client A g- =— 
Client B 
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socket connections 


Connecting, sending, and receiving 


The three things we have to learn to get the client working are: 

1. How to establish the initial connection between the client and server 
2. How to receive messages from the server 

3. How to send messages fo the server 


There’s a lot of low-level stuff that has to happen for these things to work. But we’re lucky, 
because the Java APIs make it a piece of cake for programmers. You'll see a lot more GUI 
code than networking and I/O code in this chapter. 


And that’s not all. 


Lurking within the simple chat client is a problem we haven’t faced so far in this book: 
doing two things at the same time. Establishing a connection is a one-time operation 
(that either works or fails). But after that, a chat participant wants to send outgoing messages 
and simultaneously receive incoming messages from the other participants (via the server). 
Hmm...that one’s going to take a little thought, but we’ll get there in just a few pages. 


@ Connect 


Client connects to the server 


| Make a tonnettion to 
al 196.164.1103 at port 9000 
Client A Server 


© Receive 


Client reads a message from the server 


@ +— String s = veader.readLine() 


Client A Server 


@ Send 


Client writes a message to the server 


La writer.printhn(aMessage) 


Client A Server 
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1. Connect 


connection between two machines. We can open a java.nio.channels. e : 
SocketChannel to give us this connection object. things about the server: 
What’s a connection? A relationship between two machines, where two where it 19 and which 
pieces of software know about each other. Most importantly, those ep? e 

two pieces of software know how to communicate with each other. In other P ort it 5 Trunning on. 
words, how to send bits to each other. In fl er wor ds 

We don’t care about the low-level details, thankfully, because they’re , 

handled at a much lower place ne STeavOH IMS stack.” If eo don’t Ip address and TCP 
know what the “networking stack” is, don’t worry about it. It’s just a way 

of looking at the layers that information (bits) must travel through to get port number. 


from a Java program running in a JVM on some OS, to physical hardware 
(Ethernet cables, for example), and back again on some other machine. 


The part that you have to worry about is high-level. You just have to 
create an object for the server’s address and then open a channel to that 
server. Ready? 


he 
he full address of 4 
¢ sania as connect to \P address for th 


InetSocketAddress serverAddress = new InetSocketAddress ("196.164.1.103", 5000) ; 
SocketChannel socketChannel = SocketChannel .open(serverAddress) ; 


Mh 


k +Channel ) 
in talk ‘e pee machine: Lu dove we i" Constructor to 
n 2 . 
Bass Tet ye call the statie open() 


create a 
and Connect it to the adie a 


Create a new 


The chat server is at 
196.164.1.103, port 5000. 
When I need to talk to it, 
that's where I'll send 


Port 3000 


This client is at 


Port 4242 


To make a connection, 
To talk to another machine, we need an object that represents a network you need to know two 


e server TCP Ps ort number, 
ao 


196.164.1.100, port 4242. 
When I need to talk to it, 
that's where I'll send the 
message. 


the message. 


196.164.1.100:4242 196.164.1.103: 5000 


A connection means the two machines have 
information about each other, including network 
location (IP address) and TCP pott. 
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well-known ports 


592 


A TCP port is just a number... 


a 16-bit number that identifies a 
specific program on the server 


Your internet web (HTTP) server runs on port 80. That’s a 
standard. If you’ve got a Telnet server, its running on port 23. 
FTP? 20. POP3 mail server? 110. SMTP? 25. The Time server 
sits at 37. Think of port numbers as unique identifiers. They 
represent a logical connection to a particular piece of software 
running on the server. That’s it. You can’t spin your hardware 
box around and find a TCP port. For one thing, you have 65,536 
of them on a server (0-65535). So they obviously don’t represent 
a place to plug in physical devices. They’re just a number 
representing an application. 


Without port numbers, the server would have no way of knowing 
which application a client wanted to connect to. And since each 
application might have its own unique protocol, think of the 
trouble you’d have without these identifiers. What if your web 
browser, for example, landed at the POP3 mail server instead of 
the HTTP server? The mail server won’t know how to parse an 
HTTP request! And even if it did, the POP3 server doesn’t know 
anything about servicing the HTTP request. 


When you write a server program, you'll include code that tells 
the program which port number you want it to run on (you'll 

see how to do this in Java a little later in this chapter). In the 

Chat program we're writing in this chapter, we picked 5000. Just 
because we wanted to. And because it met the criteria that it be a 
number between 1024 and 65535. Why 1024? Because 0 through 
1023 are reserved for the well-known services like the ones we just 
talked about. 


And if you’re writing services (server programs) to run on a 
company network, you should check with the sysadmins to find 
out which ports are already taken. Your sysadmins might tell 
you, for example, that you can’t use any port number below, say, 
3000. In any case, if you value your limbs, you won’t assign port 
numbers with abandon. Unless it’s your home network. In which 
case you Just have to check with your kids. 
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rTP 


Well-known TCP port numbers 
for common server applications: 


Telnet cmt? 


ime 


HTTp 


HTTPS — POP3 


A server can have up to 65,536 
ditterent server apps runnin, 
one per port. 


The TCP port 
numbers from 0 to 1023 
are reserved for wel]- 


known services. Don’t 


use them for your own 
server programs!* 


The chat server we're 
writing uses Port 
5000. We just picked a 
number between 1024 
and 65535. 


*Well, you might be able to use one of 
these, but the sysadmin where you 
work will write you a strongly worded 
message and CC your boss. 


thereyareno 
Dunb Questions 


Q: How do you know the port 
number of the server program you 
want to talk to? 


A: That depends on whether the 
program is one of the well-known 
services. If you're trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
FTP, etc.), you can look these up on 
the internet (Google “Well-Known 
TCP Port”). Or ask your friendly 
neighborhood sysadmin. 


But if the program isn’t one of the 
well-known services, you need to 
find out from whoever is deploying 
the service. Ask them. Typically, if 
someone writes a network service 
and wants others to write clients for 
it, they'll publish the IP address, port 
number, and protocol for the service. 
For example, if you want to write a 
client for a GO game server, you can 
visit one of the GO server sites and 
find information about how to write a 
client for that particular server. 


Q: Can there ever be more than 
one program running on a single 
port? In other words, can two 
applications on the same server have 
the same port number? 


A: No! If you try to bind a program 
to a port that is already in use, 

you'll get a BindException. To binda 
program to a port just means starting 
up a server application and telling it to 
run on a particular port. Again, you'll 
learn more about this when we get to 
the server part of this chapter. 
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Port number is 
Shore in the mal 


th t. 
IP address is the mall e specific 


IP address is like specifying a 
particular shopping mall, say, 
“Flatirons Marketplace" 


Port number is like naming 
a specific store, say, 
“Bob's CD Shop" 


nee 
Brain Barbell 


OK, you got a connection. The client and the server 
know the IP address and TCP port number for each 
other. Now what? How do you communicate over that 
connection? In other words, how do you move bits 

from one to the other? Imagine the kinds of messages 
your chat client needs to send and receive. 


trow do these two 
actual talk to 


each (>) here 


Client 
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receiving from the server 


2. Receive Bisse Goce tke 


client and server 
To communicate over a remote connection, you can use regular old I/O 
streams, just like we used in the previous chapter. One of the coolest / 
features in Java is that most of your I/O work won’t care what your 
high-level chain stream is actually connected to. In other words, you can 
use a BufferedReader just like you did when you were reading from a 
file; the difference is that the underlying connection stream is connected 
to a Channel rather than a File! 


j A 127.0.0.1 is the IP address Sov 
Reading from the network with BufferedReader “localhost,” in other words, the one this 
code is running on. You Can use this when 
you're testing your tlient and server on 
@ Make a connection to the server a single, stand-alone machine. You tould 
also use “localhost” here instead. 
SocketAddress serverAddr = new InetSocketAddress ("127 .0.0.1" : 5000) : 


) which 
SocketChannel socketChannel = SocketChannel .open (serverAddr) ; he ee ee 2 
Ow 
You need to open 3 GotketChannel 77 LD you that gai 
A . 
hat tonnetts to this ager is the port number tor 


: v chat server: 
Create or get a Reader from the connection = 


Reader reader = Channels.newReader(socketChannel, StandardCharsets.UTF_8) ; 


: se ‘, d to aon Charset to 
r isa. Ovi ; 
Teel eee eres the static helper methods on You peeveading sae ae 
: aioe annels Class to ereat, work. i 

Shale cravat — your SoeketChannel. reate a Reader from - . oe 

ie the BufferedReader <— 

after as our top of the chain - 

wht 
we Chain the ButferedReader te the Reader 
is from our CotketChannel : 


3) Make a BufferedReader and read! 
—$—_—_ 


BufferedReader bufferedReader = new BufferedReader (reader) ; 
String message = bufferedReader.readLine() ; 


sour le 
destiy, . 
a 
\ tion buffered characters converted to characters bytes from server 
buffered Sawaie| characters | 011010011 }*+—— 
characters chained to chained to 
BufferedReader Reader SocketChannel s data 
(we don't need to know 
the actual class) Server 
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3, Send 


In the previous chapter, we used BufferedWriter. We have a choice here, but when you’re 
writing one String at a time, PrintWriter is a standard choice. And you'll recognize the 
two key methods in PrintWriter, print() and println()! Just like good ol’ System.out. 


Writing to the network with PrintWriter This part's the same 3s a re 
the last eres sonnet 10 it: 
@) Make a connection to the server J server) we SU 


SocketAddress serverAddr = new InetSocketAddress("127.0.0.1", 5000); 


SocketChannel socketChannel = SocketChannel.open(serverAddr) ; 


fo say which Charset to 


You need she Strings. You should 
(2) Create or get a Writer from the connection a ae one for reading, as 


for writing 


Writer writer = Channels.newWriter(socketChannel, StandardCharsets.UTF_8) ; 


“toe between The Channels tlass ¢ . a 
wit a oe ie to be to treate a Weiter. er wtiliby methods 
Gets to the Channel: 


3) Make a PrintWriter and write (print) something 
———— ae 


By chaining a PrintWriter to the Channel’s 


Writer, we can wri 

: write Strings to th 

which will be sent over the € Channel, 
PrintWriter printWriter = new PrintWriter (writer) ; 


wetter preci ("message to send"); ¢_ Printhn() ad 
writer.print ("another message") ; S 2 new line af the end of 


PrintQ) doesn’t add the new line 


nnection. 


what it sends. 


destination 
source 
characters characters bytes to server 
} eh 
: chained to chained to 
PrintWriter Writer SocketChannel's data 
Client (we don't need to know 


the actual class) 
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channels vs sockets 


There’s more than one way to 
make a connection ieee bane ae) 


: ; but I know that I could 
If you look at real life code that talks to a remote machine, use a Socket instead. 
you'll probably see a number of different ways to make 
connections and to read from and write to a remote computer. 


Which approach you use depends on a number of things, 
including (but not limited to) the version of Java you’re using 
and the needs of the application (for example, how many 
clients connect at once, the size of messages sent, frequency 
or message, etc). One of the simplest approaches 1s to use a 
java.net.Socket instead of a Channel. 


Using a Socket 


You can get an InputStream or OutputStream from a Socket, and read and 
write from it in a very similar way to what we’ve already seen. 


d 
; £SotketAddress an 
Instead tee you can create a 


rn with the host and port number: 


To vead from the Socket, we 


Socket chatSocket = new Socket ("127.0.0.1", 5000) ; need to get. a, InputS# 
rom the Sotket. ream 


InputStreamReader in = new InputStreamReader (chatSocket.getInputStream() ) ; 
a ee 


) 
BufferedReader reader = new BufferedReader (in); Reader code is exactly the same as we ve 
String message = reader.readLine(); already seen. 


PrintWriter writer = new PrintWriter (chatSocket.getOutputStream() ) ; 
e 
i ket, we need to 9 
writer.println("message to send"); ae To write to the sone ane 
writer.print ("another message") ; an OutputStream te Aaawiiten 
which we Can thain to the 
dy seen: 


) 
the same as we Ve alrea 


Writer Code is exactly 


The java.net.Socket class is available in al] 
versions of Java. 


It supports simple network I/O via the I/O 
streams we've already used for file I/O. 
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If 
Socket has been in 
Java since forever, if it'sa 
bit less code to write, and if 
it does the same thing as 

Channels, why do we need 
Channels? 


As we’ve become an increasingly connected world, 
Java has evolved to offer more ways to work with 
remote machines. 


Remember that Channels are in the java.nio.channels package? The 
java.nio package (NIO) was introduced in Java 1.4, and there were 
more changes and additions made (sometimes called NIO.2) in Java 7. 


There are ways to use Channels and NIO to get better performance 
when you're working with lots of network connections, or lots of data 
coming over those connections. 


In this chapter, we’re using Channels to provide the same 
very basic connection functionality we could get from 
Sockets. However, if our application needed to work well with a 
very busy network connection (or lots of them!), we could configure 
our Channels differently and use them to their full potential, and our 
program would cope better with a high network I/O load. 


We've chosen to teach you the simplest way to get started with 
network I/O using Channels so that if you need to “level up” to 
working with more advanced features, it shouldn’t be such a big step. 


If you do want to learn more about NIO, read Java NIO by Ron 
Hitchens and Java I/O, NIO and NIO.2 by Jeff Friesen. 


Relax Channels support advanced 


networking features that you 


don’t need for these exercises. 


Channels can support nonblocking I/O, reading 
and writing via ByteBuffers, and asynchronous 
I/O. We’re not going to show you any of this! 
But at least now you have some keywords to put into your 
search engine when you want to know more. 


youarehere> 597 


writing a client 


The DailyAdviceClient 


Before we start building the Chat app, let’s 
start with something a little smaller. The 
Advice Guy is a server program that offers 


Tell your boss 


Don't forget self-care; the report will 


you can't be effective have to wait. There's 


if you're running on 


: powder at Aspen! 
umes! 


up practical, inspirational tips to get you 
through those long days of coding, 


We're building a client for The Advice Guy 


program, which pulls a message from the That shade of 
green isn't really 


workin’ for you... 


server each time it connects. 


What are you waiting for? Who knows what 
opportunities you’ve missed without this app. 


The Advice Guy 


@ Connect 


Client connects to the server 


Make a Connection to 
— 190.165.1103 at port 5000 


Client Server 


© Read 


Client gets a Reader for the Channel, and reads a message 
from the server 


| Channels.newReader() 
" advite = reader-readLine() 


Client Server 
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DailyAdviceClient code 


This program makes a SocketChannel, makes a BufferedReader (with 
the help of the channel’s Reader), and reads a single line from the server 
application (whatever is running at port 5000). 


import java.io.*; 
import java.net.InetSocketAddress ; 
import java.nio.channels.Channels; 


import java.nio.channels.SocketChannel ; 


import java.nio.charset.StandardCharsets; s as being, port 
Line the server addres idan 
Debig re tse A 
public class DailyAdviceClient { nee on (th “\oealhos 


public void go() { —{ 


InetSocketAddress serverAddress = new InetSocketAddress ("127.0.0.1", 5000) ; 


try (SocketChannel socketChannel = SocketChannel.open(serverAddress)) { 
0.0 OOS 


“ty—resourles Create as 
is uses bey—wie otketCha 
Te sctomatically eee Create a Reader that reads For the server's ose PY eFening one 
Seeket Channel “en from the SocketChannel. 
is Complete: 


Reader channelReader = Channels.newReader (socketChannel, StandardCharsets.UTF_ 8) ; 


BufferedReader reader = new BufferedReader (channelReader) ; 


NY Chaina BufferedReader 
Lo the Reader from the 


String advice = reader.readLine() ; aie GoeketChannel- 
System.out.println ("Today you should: " + advice) ; ; 


This closes the channelReader and 


reader .close() <- this BufferedReader. ButferedR - ae Cre using g 
} catch (IOException e) { cal sf ds, by Ty a FILE 
e.printStackTrace () ; cader doesn't pater meth, len 
} © Characters ¢ ame f are where 


public static void main(String[] args) { 
new DailyAdviceClient() .go() ; 
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exercise: sharpen your pencil 


harpen your pencil 


——_> . 
DA Test your memory of the classes for reading and writing from a Yours to solve 


SocketChannel. Try not to look at the opposite page! 


Sour, 
To read text from a SocketChannel: te 


Write/draw in the chain of classes the client 
uses to read from the server. Server 


destj, «1: 
To send text to a SocketChannel: estination 


Write/draw in the chain of classes the client 


Client uses to send something to the server. Server 


re harpen your pencil 
aN Fill in the blanks: —> Your’ to solve. 


What two pieces of information does the client need in order to make a connection with a 
server? 


Which TCP port numbers are reserved for “well-known services” like HTTP and FTP? 


TRUE or FALSE: The range of valid TCP port numbers can be represented 
by a short primitive. 
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Writing a simple server application 


So what’s it take to write a server application? Just a couple of 
Channels. Yes, a couple as in two. A ServerSocketChannel, 
which waits for client requests (when a client connects) and 

a SocketChannel to use for communication with the client. 

If there’s more than one client, we’ll need more than one 
channel, but we’ll get to that later. 


How it works: 


@ Server application makes a ServerSocketChannel and binds it to a specific port 


ServerSocketChannel serverChannel = ServerSocketChannel.open() ; ‘ 
serverChannel .bind(new InetSocketAddress (5000) ) ; Cerver Pr 


This starts the server application listening for client | 
requests coming in for port 5000. : 


© Client makes a SocketChannel connected to the server application 
SocketChannel svr = SocketChannel.open(new InetSocketAddress ("190.165.1.103", 5000)); 


Client knows the IP address and port number 
(published or given to them by whomever configures | 
the server app to be on that port). 


3) Server makes a new SocketChannel to communicate with this client 


SocketChannel clientChannel = serverChannel.accept() ; 


The accept() method blocks (just sits there) while it's 
waiting for a client connection. When a client finally 
connects, the method returns a SocketChannel that 
knows how to communicate with this client. 


ay. york 


The ServerSocketChannel can go back to waiting 


for other clients. The server has just one 
ServerSocketChannel, and a SocketChannel per client. 


youarehere> 601 


writing a server 


DailyAdviceServer code 


This program makes a ServerSocketChannel and waits for client requests. When it gets a client request (1.e., client 
created a new SocketChannel to this server), the server makes a new SocketChannel to that client. The server 
makes a PrintWriter (using a Writer created from the SocketChannel) and sends a message to the client. 


import java.io.*; 
import java.net. InetSocketAddress; : ks. 
import java.nio.channels.*; Re memoer dhe impor 
import java.util.Random; 
public class DailyAdviceServer { 
final private String[] adviceList = { . this array: 
"Take smaller bites", Daily advice Comes sia 
"Go for the tight jeans. No they do NOT make you look fat.", 


"One word: inappropriate", 
"Just for today, be honest. Tell your boss what you *really* think", 
. ver 
s this SO" the 


"You might want to rethink that haircut."}; 1 weake 
i final R = R : e\ md! 
private fina andom random new Random () CerverSotketChany ce sient reques 
Wieation listen 
\ 
ary 5 v's pound 


public void go() { 


ServerSocketChannel.open()) { 
bind the ServerSocketChannel to 
£ to run the application on. 


try (ServerSocketChannel serverChannel 
serverChannel.bind(new InetSocketAddress (5000) ) ; You have to 


he port you 0 
ust sits there) until a 


: ay + loop, 
The server goes into are a ests: The accept method blocks (5 
waiting for Cand servicing) client reat C request Comes in, and then be method returns a 


while (serverChannel.isOpen()) { 
$ serverChannel. accept () ; 


SotketChannel for Communicating, with the client. 


SocketChannel clientChannel = 
new PrintWriter (Channels .newOutputStream(clientChannel) ) ; 


PrintWriter writer = 
es ) 
s 
String advice = getAdvice() ; Create an output stream for the client 
i i i . channel, and wrap it in a PrintWriter. You can 
writer.println (advice) ; : : 
use newOutputStream or newWriter here. 


» SO 
9 


er Console 
happenin 


Ss 


) 


part 

o 2 i 

oe writer.close() ; 

—< : i 

> ev ~>System.out.printin (advice) ; Send ; . 

s 8 } the client a String advice message. 

= 
= S$} catch (IOException ex) { Close the writ 
a Y ex.printStackTrace() ; will also ties cr, whieh 
Soeketc e the tlient 
hanne| =) 


~ 


Brain Barbell 


private String getAdvice() { 
random. nextInt (adviceList.length) ; 


~ 


int nextAdvice = 
How does the server know how to 


return adviceList[nextAdvice] ; 
} communicate with the client? 
public eeatie veld mata (Spa it.-eage) Think about how/when/where the server 
gets knowledge about the client. 


new DailyAdviceServer () .go() ; 


} 
} 
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CL 


The 
advice server code 
on the opposite page has a VERY 
serious limitation—it looks like it 
can handle only one client at a time! 
Is there a way to make a server 
that can handle multiple clients 
concurrently? This would never work 
for a chat server, for instance. 


Yes, that’s right, the server can’t accepta 
request from a client until it has finished 
with the current client. At which point, it 
starts the next iteration of the infinite loop, 
sitting, waiting, at the accept() call until a new 
request comes in, at which point it makes a 
SocketChannel to send data to the new client 
and starts the process over again. 


To get this to work with multiple clients at the 
same time, we need to use separate threads. 


We'd give each new client's SocketChannel 
to a new thread, and each thread can work 
independently. 


We're just about to learn how to do that! 


___—— BULLET POINTS 


networking and threads 


Client and server applications communicate using Channels. 


A Channel represents a connection between two applica- 
tions that may (or may not) be running on two different 
physical machines. 


A client must know the IP address (or host name) and TCP 
port number of the server application. 


ATCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
server applications to run on the same machine; clients con- 
nect to a specific application using its port number. 


The port numbers from 0 through 1023 are reserved for 
“well-known services” including HTTP, FTP, SMTP, etc. 


A client connects to a server by opening a SocketChannel: 
SocketChannel . open ( 
new InetSocketAddress ("127.0.0.1", 4200) ) 


Once connected, a client can create readers (to read data 

from the server) and writers (to send data to the server) for 

the channel: 

Reader reader = Channels .newReader (sockCh, 
StandardCharsets.UTF 8) ; 


Writer writer = Channels.newWriter (sockCh, 
StandardCharsets.UTF 8) ; 


To read text data from the server, create a BufferedReader, 
chained to the Reader. The Reader is a “bridge” that takes 
in bytes and converts them to text (character) data. It's used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level connection. 


To write text data to the server, create a PrintWriter chained 
to the Writer. Call the print() or printIn() methods to send 
Strings to the server. 


Servers use a ServerSocketChannel that waits for client 
requests on a particular port number. 


When a ServerSocketChannel gets a request, it “accepts” 
the request by making a SocketChannel for the client. 
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a simple chat client 


Writing a Chat Client 


We'll write the Chat Client application in two stages. First we’ll make 
a send-only version that sends messages to the server but doesn’t get 


to read any of the messages from other participants (an exciting and 
mysterious twist to the whole chat room concept). 


Then we’ll go for the full chat monty and make one that both sends 
and receives chat messages. 
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Version One: send-only 


eee Ludicrously Simple Chat Client ) 7 pe a einige’ pn W 
send it ig 
sere 4 mene: FROM AH 
server in 
no stalling 


Code outline 


Here’s an outline of the main functionality the chat client needs to 
provide. The full code is on the next page. 


public class SimpleChatClientaA { 
private JTextField outgoing; 
private PrintWriter writer; 


public void go() { 
// call the setUpNetworking() method 
// make gui and register a listener with the send button 


private void setUpNetworking() { 
// open a SocketChannel to the server 
// make a PrintWriter and assign to writer instance variable 


private void sendMessage() { 
// get the text from the text field and 
// send it to the server using the writer (a PrintWriter) 
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network 


import javax.swing.*; |mports Lor writing Gavaions and the 


import java.awt.*; 
import java.io.*; 
import java.net. InetSocketAddress; 


; (€ ava.nio-channels 
comer and 


import java.nio.channels.*; This is a static import; we ad at 
import static java.nio.charset.StandardCharsets.UTF_8; statie imports in Chapter 10. 
——————— Eee . 00S 


public class SimpleChatClientaA { 
private JTextField outgoing; 
private PrintWriter writer; 


Call the method that will 


public void go() { LZ tonnett to the server: 


} 


private void setUpNetworking() { 


setUpNetworking() ; 
outgoing = new JTextField(20) ; 


JButton sendButton = new JButton ("Send") ; 
sendButton.addActionListener(e -> sendMessage() ) ; 


hind, New 
ild the Bul, not 
ae and nothind, related to 


king, oF . 
JPanel mainPanel = new JPanel () ; netwe 9 


mainPanel .add (outgoing) ; 

mainPanel .add(sendButton) ; 

JFrame frame = new JFrame("Ludicrously Simple Chat Client") ; 
frame .getContentPane() .add(BorderLayout.CENTER, mainPanel) ; 
frame.setSize(400, 100); 

frame.setVisible (true) ; 

frame .setDefaultCloseOperation (WindowConstants .EXIT_ON_CLOSE) ; 


We've usin localhost 
tan test fhe client ner a 


server on one : 
try { machine. 


InetSocketAddress serverAddress = new InetSocketAddress ("127.0.0.1", 5000) ; 

SoeketChannel 
SocketChannel socketChannel = SocketChannel .open (serverAddress) x ae t nets tks to the 
writer = new PrintWriter (Channels.newWriter(socketChannel, UTF_8)); 


System.out.printlin ("Networking established.") ; th server: 
h (IOE i - ake tne 
} Gatch (IOException i { This is where we ™ ee that 
e.printStackTrace () ; Pri tWriter from a Ww 
ie th SotketChanne 
} w ' 
: emem 
. . iting Wn (4 
private void sendMessage() { tually do cea “hse citer eam 0 
writer .println(outgoing.getText()); | Now We a ' . do a YX 
writer. flush () ; ke weiter A; er Lh server 
outgoing.setText("") ; Gotket Chan khe netwo 
outgoing. requestFocus () ; a“ goes ove 


} 


public static void main(String[] args) { 


} 


If you want to try this now, type in 
the Ready-bake chat server code 
listed on the next page. 


new SimpleChatClientA() .go() ; First, start the server in one terminal. 
Next, use another terminal to start 
this client. 
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chat server code 


qf 


import 
import 
import 
import 
import 


import 


Ready-Bake 
Cade 


The really, really simple Chat Server 


You can use this server code for all versions of the Chat Client. Every possible disclaimer 
ever disclaimed is in effect here. To keep the code stripped down to the bare essentials, we 
took out a lot of parts that you’d need to make this a real server. In other words, it works, 
but there are at least a hundred ways to break it. If you want to really sharpen your skills 
after you've finished this book, come back and make this server code more robust. 


After you finish this chapter, you should be able to annotate this code yourself. You'll 
understand it much better if_yow work out what’s happening than if we explained it to you. 
Then again, this is Ready-Bake Code, so you really don’t have to understand it at all. It’s 
here just to support the two versions of the Chat Client. 


To run the Chat Client, you need two 
terminals. First, launch this server 


java.io.*; from one terminal, and then launch 
java.net.InetSocketAddress ; the client from another terminal. 
java.nio.channels.*; 


java.util.*; 
jJava.util.concurrent.*; 


static java.nio.charset.StandardCharsets.UTF_8; 


public class SimpleChatServer { 
private final List<PrintWriter> clientWriters = new ArrayList<>() ; 


public static void main(String[] args) { 
new SimpleChatServer () .go() ; 


} 


public void go() { 

ExecutorService threadPool = Executors .newCachedThreadPool () ; 

try { 
ServerSocketChannel serverSocketChannel = ServerSocketChannel.open () ; 
serverSocketChannel.bind(new InetSocketAddress (5000) ) ; 


while (serverSocketChannel.isOpen()) { 


} 


SocketChannel clientSocket = serverSocketChannel.accept() ; 

PrintWriter writer = new PrintWriter(Channels.newWriter(clientSocket, UTF_8)); 
clientWriters.add(writer) ; 

threadPool.submit (new ClientHandler (clientSocket) ) ; 

System.out.println ("got a connection") ; 


} catch (IOException ex) { 
ex.printStackTrace () ; 


} 
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private void tellEveryone (String message) { 
for (PrintWriter writer : 
writer.println (message) ; 
writer.flush () ; 


} 


clientWriters) { 


} 


public class ClientHandler implements Runnable { 
BufferedReader reader ; 
SocketChannel socket; 


public ClientHandler(SocketChannel clientSocket) { 
socket = clientSocket; 
reader = 


new BufferedReader (Channels.newReader (socket, UTF_8)); 
} 
public void run() { 
String message; 
try { 
while ((message = reader.readLine()) != null) { 
System.out.println("read " + message) ; 
tellEveryone (message) ; 
} 
} catch (IOException ex) { 
ex.printStackTrace () ; 


File Edit Window Help TakesTwoToTango 


Sjava SimpleChatServer 


File Edit Window Help MaylHaveThisDance? 


Sjava SimpleChatClientA 


got a connection 


read Nice to meet you 


Networking established. Client 
running at: /127.0.0.1:57531 


Connects to the 


server and launches 


Gul 


Runs in the background 


youarehere> 607 


improving the chat client 


Version Two: send 


and receive 


incoming, 
messages 


outgoing message 


~~ udicrousty Simple 


You are 50 kewlll!! 


software and go home 


i ht 
xclamation mark. One is enoug 
Who's in here right now! 
DarkStar 
MuffinPerson 
hegerr up MuffinPerson? 


Who said that? 


chat Client = 
——_ 1? 
Chicken stree! 
x to Sesame 
me how to ge 


time, ! 
\f you spell it like that one more 


yy take my 


abused, 
f the poor, 
r overuse ° 
rove of you 


Send _ 
[think it was Darkstatl > 


The Server sends a message to all 

client participants, as soon as the 

message is received by the server. 
When a client sends a message, it 
doesn't appear in the incoming 
message display area until the 
server sends it to everyone. 


Big Question: HOW do you get messages from the server? 


messages using readLine. 


Should be easy; when you set up the networking, make a Reader as well. Then read 


Bigger Question: WHEN do you get messages from the server? 
Think about that. What are the options? 


sends a message. 


@) Option One: Read something in from the server each time the user 


Pros: Doable, very easy. 


lurker and doesn’t send anything? 


Cons: Stupid. Why choose such an arbitrary time to check for messages? What if a user is a 


@) Option Two: Poll the server every 20 seconds. 


Pros: It’s doable, and it fixes the lurker problem. 


Cons: How does the server know what you’ve seen and what you haven’t? The server would have 
to store the messages, rather than just doing a distribute-and-forget each time it gets one. And 


server needlessly. Inefficient. 


why 20 seconds? A delay like this affects usability, but as you reduce the delay, you risk hitting your 


@® Option Three: Read messages as soon as they’re sent from the server. 
Pros: Most efficient, best usability. 


Cons: How do you do two things at the same time? Where would you put this code? You’d need 
a loop somewhere that was always waiting to read from the server. But where would that go? 
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Once you launch the GUI, nothing happens until an event is fired by a GUI component. 


You know by now that we’re 
going with option three 


We want something to run continuously, 
checking for messages from the server, but 
without interrupting the user’s ability to interact 
with the GUI! So while the user is happily 
typing new messages or scrolling through 
the incoming messages, we want something 
behind the scenes to keep reading in new input 
from the server. 


That means we finally need a new thread. A 
new, separate stack. 


We want everything we did in the Send-Only 
version (version one) to work the same way, 
while a new process runs alongside that reads 
information from the server and displays it in 
the incoming text area. 


Well, not quite. Each new Java thread is not 
actually a separate process running on the 
OS. But it almost feels as though it is. 


We're going to take a break from the chat 
application for a bit while we explore how 
this works. Then we'll come back and add it 
to our chat client at the end of the chapter. 


networking and threads 


In Java you really CAN 
walk and chew gum at 
the same time. 


Multithreading in Java 


Java has support for multiple threads built 
right into the fabric of the language. And it’s 
a snap to make a new thread of execution: 


Thread t = new Thread() ; 
t.start(); 


That’s it. By creating a new Thread object, 
you've launched a separate thread of execution, 
with its very own call stack. 


Except for one problem. 


That thread doesn’t actually do anything, 
so the thread “dies” virtually the instant 
it’s born. When a thread dies, its new stack 
disappears again. End of story. 


So we’re missing one key component—the 
thread’s job. In other words, we need the 
code that you want to have run by a separate 
thread. 


Multiple threading in Java means we have to 
look at both the thread and the job that’s run 

by the thread. In fact, there’s more than 
one way to run multiple jobs in Java, 
not just with the Thread class in the java.lang 
package. (Remember, java.lang is the package 
you get imported for free, implicitly, and it’s 
where the classes most fundamental to the 
language live, including String and System.) 
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threads and Thread 


Java has multiple threads but only 
one Thread class 


We can talk about thread with a lowercase “t” and Thread 
with a capital “T’” When you see thread, we’re talking about 

a separate thread of execution. In other words, a separate 
call stack. When you see Thread, think of the Java naming 
convention. What, in Java, starts with a capital letter? Classes 
and interfaces. In this case, Thread 1s a class in the java.lang 
package. A Thread object represents a thread of execution. In 
older versions of Java, you always had to create an instance of 
class Thread each time you wanted to start up a new thread 
of execution. Java has evolved over time, and now using the 
Thread class directly is not the only way. We'll see this in 
more detail as we go through the rest of the chapter. 


thread 


main thread another thread 
started by the code 


A thread (lowercase “t”) is a separate thread of execution. That 
means a separate call stack. Every Java application starts up a 
main thread—the thread that puts the main() method on the 
bottom of the stack. The JVM is responsible for starting the 
main thread (and other threads, as it chooses, including the 
garbage collection thread). As a programmer, you can write 
code to start other threads of your own. 
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A thread is a separate 
“thread of execution,” a 
separate cal] stack. 


A Thread is a Java class 


that represents a thread. 


Using the Thread class 
18 not the only way to do 
multithreading in Java. 


Thread 


Thread 
void join() 
void start() 


static void sleep() 


java.lang.Thread 
class 


Thread (capital “T”) is a class that 
represents a thread of execution. It 
has methods for starting a thread, 
joining one thread with another, 
putting a thread to sleep, and more. 


networking and threads 


What does it mean to have more than 
one call stack? 


With more than one call stack, you can have multiple things happen at the same time. If 
you're running on a multiprocessor system (like most modern computers and phones), you can 
actually do more than one thing at a time. With Java threads, even if you’re not running on a 
multiprocessor system or if you’re running more processes than available cores, it can appear 
that you’re doing all these things simultaneously. In other words, execution can move back and 
forth between stacks so rapidly that you feel as though all stacks are executing at the same time. 
Remember, Java is just a process running on your underlying OS. So first, Java zse/f has to be 
“the currently executing process” on the OS. But once Java gets its turn to execute, exactly what 
does the JVM run? Which bytecodes execute? Whatever is on the top of the currently running 
stack! And in 100 milliseconds, the currently executing code might switch to a different method 
on a different stack. 


One of the things a thread must do is keep track of which statement (of which method) is 
currently executing on the thread’s stack. 


It might look something like this: 


The active thread 


@ The JVM calls the main() method. y 


public static void main(String[] args) { = r : id 


a main thread 
} 


A new thread starts 
and becomes the active 
main() starts a new thread. The main thread 


thread may be temporarily frozen while 


a 
t.start 
the new thread starts running. o 


i main() 
Runnable r = new MyThreadJob() ; wane 
Thread t = new Thread(r) ; You'll lea ; main thread user thread “t 

2 R- rn 

t.start(); is means ny ss 
Dog d = new Dog(); a moment... J 

; ad agen 

The acune ore v 


ra 
i x.go() 


| run() ) 


main thread user thread “t” 


3) The JVM switches between the new 
thread (user thread A) and the original 
main thread, until both threads complete. 
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Runnable interface 


To create a new call stack you need a job to run 


All I need is a real job. 
Just give me a Runnable, 
and I'll get to work! 


Runnable is to a thread 
what a job is to a 
worker. A Runnable 

i the job a thread is 
supposed to run. 


A Runnable holds the 
method that goes on the 
bottom of the new cal] 
stack: run(). 


To start a new call stack the thread needs a job—a job the thread will run 


when it’s started. ‘That job is actually the first method that goes on the new fines Y one : 
thread’s stack, and it must always be a method that looks like this: able anterkate . a it Was only \ 
n : 
public void run() { The Run ate vod OO ge, a runction® 
// code that will be run by the new thread method X 4 it’s a SAM 2 \ wid anstead 
} sino le Me mie a an use i: Tglemen 
ce, S$ t) 
Inert na whole 18s 
How does the thread know which method to put at the bottom of the ok preating e wa 
stack? Because Runnable defines a contract. Because Runnable is an Runnable fk you 


interface. A thread’s job can be defined in any class that implements the 
Runnable interface, or a lambda expression that is the right shape for the 
run method. 


Once you have a Runnable class or lambda expression, you can tell the 
JVM to run this code in a separate thread; you’re giving the thread its job. 
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To make a job for your thread, 
implement the Runnable interface guna in pela 


) impor ~ 


‘a so you don 


public class MyRunnable implements Runnable { 


public void run() { 
go(); ee Runnable has only one method to 
} aseaai se void vun() (with no 
rouments). is is wher 
public void go() { 208 the ae is supposed to 4 - 
doMore () ; Is the method that 
2) } of the new stack. Sees at the bath 
| see Mn public void doMore() { 
ee Lor nis System.out.printin (Thread.currentThread().getName() + ~e 
don the ": top o’ the stack"); r ont veally need tne 
tyre? ; Yes: Thread .dumpStack () ; This Runnable oe " tall eath other 
ext P29 kiny methods, which 2 demonstrate 
we ve gon wy? } dc ; pe weve using, v ; : tode 
: pStack wi like this: this 
sad ae Just like an atid the current: gall stack what the call stack running, 
Vv - i 
Le over the 7 ei vs curent doe et Using it hee lees 
ee US€ this d : “KX, but you sh 
“ code down). ” 4€>88ing (it might clon 4 


How NOT to run the Runnable 


It may be tempting to create a new instance of the Runnable and call the run method, 
but that’s not enough to create a new call stack. 


class RunTester { 
public static void main(String[] args) { 
MyRunnable runnable = new MyRunnable() ; 
runnable.run() ; 
System.out.println(Thread.currentThread().getName() + 
": back in main") ; 


Thread. dumpStack () ; This will NOT do what we want! 
—_ 


} 


inside the main() method, so it's part of 
the call stack of the main thread. 


main thread 
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How we used to launch a new thread 


The simplest way to launch a new thread is with the Thread class that we 

mentioned earlier. This method has been around in Java since the very 

beginning, but it is no longer the recommended approach to use. 

We’re showing it here because a) it’s sumple, and b) you'll see it in the Real 

World. We will talk later about why it might not be the best approach. 

stance into the 

new Thread constructor: hase A 
: run. |n fo) 

{head what , lb KA . ethod will be the 


ral ie the new thread will run. 
i\ gs m 


class ThreadTester { Pass the new Runnable in 
public static void main(String[] args) { 


Runnable threadJob = new MyRunnable() ; 
Thread myThread = new Thread (threadJob) ; 


myThread. start () ; ——+___ 
1) : You won’ get a new thread of ex 


. ecution until 
d's System. out.println ( you call start) on the Th i 
This Tes Thread.currentThread().getName() + 1s not really a thread ntl ise ponte 
skatk ": back in main") ; ee ee a Thread instance like : : vii 
Thread. dumpStack () ; object, but it won't have any real “thweddne "s 
ness. 


—  @ 
Now we have two 
independent call 


ce stacks. 
main thread new thread 
I stack for the “main ; Call stack for the new 
ies of the oe thread we started with the 
(started by the puene D MyRunnable job. 


static void. main method). 


File Edit Window Help Duo 
$java ThreadTester 


jurepstaek? main: back in main 
talled {rom Thread-0: top o’ the stack 
goMore \e java.lang.Exception: Stack trace 
MyRunnde € at java.base/java.lang.Thread.dumpStack (Thread. java: 1383) 
at ThreadTester.main (MyRunnable. java: 38) Note the 
java.lang.Exception: Stack trace mens method 
at java.base/java.lang.Thread.dumpStack (Thread. java:1383) is NOT the 
dumpStaek0 -() at MyRunnable.doMore (MyRunnable.java:15) bottom of 
talled ‘rom main at MyRunnable.go (MyRunnable.java:10) - et 
method at MyRunnable. run (MyRunnable. java: 6) aaa the 


at java.base/java.lang. Thread. run (Thread. java: 829) 
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A better alternative: don't manage the 
Threads at all 


Creating and starting a new Thread gives you a lot of control over that Thread, but the 
downside 1s you have to control it. You have to keep track of all the Threads and make sure 
they’re shut down at the end. Wouldn’t it be better to have something else that starts, stops, and 


even reuses the Threads so you don’t have to? 


Allow us to introduce an interface in java.util.concurrent, 
ExecutorService. Implementations of this interface will execute jobs 
(Runnables). Behind the scenes the ExecutorService will create, reuse, and 
lull threads in order to run these jobs. 


The java.util.concurrent.Executors class has factory methods to 
create the ExecutorService instances we’ll need. 


Executors have been around since Java 5 and so should be available to you 
even if you’re working with quite an old version of Java. There’s no real 
need to use Thread directly at all these days. 


Static factory methods 
can he used instead of 
constructors. 


Factory methods return 
exactly the implementation 
of an interface that we 


need. We don’t need to 
know the concrete classes 


a a 
Running one job or how to create them 
For the simple cases we’re going to get started with, we'll want to run only : 
one job in addition to our main class. There’s a single thread executor that we 


can use to do this. 


3 Thread instante, use 2 


class ExecutorTester { Instead of ‘aca i i ake an 
(a 
public static void main(String[] args) { ie 


Runnable job = new MyRunnable(); 


ExecutorService executor = Executors.newSingleThreadExecutor () ; 
executor .execute (job) ; 
SS eee 


Tell the ExeeutorService to run the 
job. It will take eave of starting a 
new thread for the job if it needs to. 
System.out.printin(Thread.currentThread().getName() + 
": back in main"); 
Thread. dumpStack () ; 
executor. shutdown () ; 
—_—=_>- 


In our Case, we onl 

to start a single ies 
it’s logical to treate a 
single thread executor. 


} Service 
+ Remember to, shut verte eee he come back to the Executors 
when ou've pinenee am will hand around ctory methods later, and we'll 


see why it might be better to use 
ExecutorServices rather than 
managing the Thread itself. 


shut P down, the proy 
waiting Lor more Jor: 


615 


you are here > 


thread states 


The three states of a new thread 


Whether you create a new Thread and pass it the Runnable, or use an 
Executor to execute the Runnable, the job will still be running on a Thread. 
A Thread will move through a number of different states during its life, and 
understanding these states, and the transitions between them, helps us to 
better understand multithreaded programming. 


“Pm waiting, to 
get started.” 


A Thread instance has been 
created but not started. In other 
words, there is a Thread object, 
but no thread of execution. 


‘E) aS « =e 
wee 


RUNNABLE 


A 


When you start the thread, it 
moves into the runnable state. ‘This 
means the thread is ready to run 
and just waiting for its Big Chance 
to be selected for execution. At this 
point, there is a new call stack for 
this thread. 


But there’s more. Once the thread becomes 


runnable, it can move back and forth between 


runnable, running, and an additional state: 
temporarily not runnable. 
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Selected to run 


thread 


This 1s ane a 


wants to be! 


« Can | 
supersize 
that for 


yous” 


This is the state all threads lust 
after! To be Up And Running. 
Only the JVM thread scheduler 
can make that decision. You can 
sometimes influence that decision, 
but you cannot force a thread to 
move from runnable to running. 
In the running state, a thread (and 
ONLY this thread) has an active 
call stack, and the method on the 
top of the stack is executing. 
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Typical runnable/running loop 


Typically, a thread moves back and forth 
between runnable and running, as the 

JVM thread scheduler selects a thread to 
run and then kicks it back out so another 


thread gets a chance. 


A thread can be made 


temporarily not-runnable 


The thread scheduler can move a 
running thread into a blocked state, for 
a variety of reasons. For example, the 
thread might be executing code to read 
from an input stream, but there isn’t 
any data to read. The scheduler will 
move the thread out of the running state 
until something becomes available. Or 
the executing code might have told the 
thread to put itself to sleep (sleep()). Or 
the thread might be waiting because 

it tried to call a method on an object, 
and that object was “locked.” In that 
case, the thread can’t continue until the 
object’s lock is freed by the thread that 
has it. 


All of those conditions (and more) cause 
a thread to become temporarily not- 
runnable. 


RUNNABLE RUNNING 


A Selected to run 
ee =~ A> 


Sent back to runnable 
so another thread can 
have a chance 


RUNNABLE RUNNING 


Sleeping, waiting for another thread to finish, 
waiting for data to be available on the stream, 
waiting for an object's loek... 
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The thread scheduler 


The thread scheduler makes all the decisions about who 
moves from runnable to running, and about when (and 
under what circumstances) a thread leaves the running 

state. The scheduler decides who runs, for how long, and 
where the threads go when it decides to kick them out of the 


currently running state. 


You can’t control the scheduler. There is no API for calling Number four, you've had 


methods on the scheduler. Most importantly, there are enough time. Back to runnable. 
no guarantees about scheduling! (There are a few almost- Number two, looks like you're up! 


guarantees, but even those are a little fuzzy.) Ghi now Mlgcke like vouregenahave 


to sleep. Number five, come take his 
place. Number two, you're still 


The bottom line is this: do not base your program’s 
correctness on the scheduler working in a particular 


way! The scheduler implementations are different for ; 
different JVMs, and even running the same program on the sleeping... 


same machine can give you different results. One of the 


20 


worst mistakes new Java programmers make is to test 
their multithreaded program on a single machine, and 


assume the thread scheduler will always work that way, 
regardless of where the program runs. 


So what does this mean for write-once-run-anywhere? It 
means that to write platform-independent Java code, your 


The thread scheduler 
makes al] the 
decisions about who 
runs and who doesn’t. 
It usually makes the 
threads take turns, 
nicely. But there’s no 
guarantee about that. 
It might let one thread 
run to its heart’s 
content while the 
other threads “starve.” 


multithreaded program must work no matter how the thread 
scheduler behaves. That means you can’t be dependent on, 
for example, the scheduler making sure all the threads take 
nice, perfectly fair, and equal turns at the running state. 
Although highly unlikely today, your program might end up 
running on a JVM with a scheduler that says, “OK, thread 
five, you’re up, and as far as I’m concerned, you can stay 
here until you’re done, when your run() method completes.” 
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An example of how unpredictable the 
scheduler can be... 


Running this code on one machine: Produced this output: 


unetional Interface 


is a 4 
aye” represented 35 8 
an . 


\ob 1 
lambda ones lambda java ExecutorTestDrive 
: ine o , 2 : 
a single ne akes sense here- back in main 


, sion ™ 
class ExecutorTestDrive { expres 


public static void main (String[] args) { 
ExecutorService executor = java ExecutorTestDrive 
Executors .newSingleThreadExecutor () ; 


top o’ the stack 


top o’ the stack 


executor.execute(() -> back in main 


System.out.printlin ("top o’ the stack") ) ; java ExecutorTestDrive 


System.out.println("back in main") ; top o’ the stack 
executor. shutdown () ; Dako omaan 
} es 
} Notice how the order ante Lyvead java ExecutorTestDrive 
° Sometimes the » ain 
andor, . and sometimes the ™ back in main 
wnishes TSU) Sa 
pat finishes fist. top o’ the stack 


java ExecutorTestDrive 


top o’ the stack 


It doesn't matter if you run this 
using an ExecutorService, like 

the code above, or with Threads 
directly, like the code below; both 
show the same symptoms. 


back in main 


java ExecutorTestDrive 


top o’ the stack 


back in main 


java ExecutorTestDrive 
back in main 
class ThreadTestDrive { top o’ the stack 
public static void main (String[] args) { 
Thread myThread = new Thread(() -> 
System.out.println("top o’ the stack")) ; 
myThread.start() ; 
System.out.println("back in main") ; 


} 
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How did we end up with different results? 


Multithreaded programs are not deterministic; they don’t run the same way every time. The 
thread scheduler can schedule each thread differently each time the program runs. 


Sometimes it runs like this: 


main() starts the The scheduler sends — The scheduler lets The new thread goes 
new job running. the main thread out the new threadrun | away, because it has 
of running and back to completion, print-} finished the job. The 
to runnable, so that ing out “top o’ the main thread once again 
the new thread can stack.” becomes the running 
run. thread and prints “back 
in main.” 
executor exec | executor.execute: ) 
main | — main() ] (maint) 
main thread main thread new thread main thread 
time 


And sometimes it runs like this: 


main() starts the The scheduler sends The scheduler lets the] The scheduler The scheduler The new thread returns 
new thread. the main thread out —_ new thread run, but sends the new selects the main to the running state 
of running and back _ not long enough to thread back to thread to be the and prints out “top o’ 
to runnable, so that + complete everything. | runnable. running thread the stack.” 
the new thread can again. Main prints 
run. out “back in main.” 
exectitor execut lexecutor.execute ) 
ae | ol =a 
main thread main thread new thread new thread main thread new thread 
time 


Even $f the new thread is tiny, if it has only one ine 
of code to run like our lambda expression, it can stil] 
he interrupted by the thread scheduler. 
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Dumb Questions 


Q: Should | use a lambda expression for my 
Runnable or create a new class that implements 
Runnable? 


A: It depends upon how complicated your 

job is, and also on whether you think it’s easier to 
understand as a lambda expression or a class. 
Lambda expressions are great for when the job 

is really tiny, like our single-line “print” example. 
Lambda expressions (or method references) may 
also work if you have a few lines of code in another 
method that you want to turn into a job: 


executor.execute(() -> printMsg() ) ; 


You'll most likely want to use a full Runnable class 
if your job needs to store things in fields and/or if 
your job is made up of a number of methods. This 
is more likely when your jobs are more complex. 


+ What's the advantage of using an 
ExecutorService? So far, it works the same as 
creating a Thread and starting it. 


A: It’s true that for these simple examples, 
where we're starting just one thread, letting 

it run, and then stopping our application, the 

two approaches seem similar. ExecutorServices 
become really helpful when we're starting lots of 
independent jobs. We don’t necessarily want to 
create a new Thread for each of these jobs, and we 
don’t want to keep track of all these Threads. There 
are different ExecutorService implementations 
depending upon how many threads we'll want 

to start (or especially if we don’t know how many 
Threads we'll need), including ExecutorServices 
that create Thread pools. Thread pools let us reuse 
Thread instances, so we don't have to pay the cost 
of starting up new Threads for every job. We'll 
explore this in more detail later. 
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BULLET POINTS 


A thread with a lowercase “t” is a separate thread of execution 
in Java. 


Every thread in Java has its own call stack. 


A Thread with a capital “T” is the java.lang. Thread class. A 
Thread object represents a thread of execution. 


A thread needs a job to do. The job can be an instance of 
something that implements the Runnable interface. 


The Runnable interface has just a single method, run(). This 
is the method that goes on the bottom of the new call stack. In 
other words, it is the first method to run in the new thread. 


Because the Runnable interface has just a single method, you 
can use lambda expressions where a Runnable is expected. 


Using the Thread class to run separate jobs is no longer the 
preferred way to create multithreaded applications in Java. 
Instead, use an Executor or an ExecutorService. 


The Executors class has helper methods that can create 
standard ExecutorServices to use to start new jobs. 


A thread is in the NEW state when it has not yet started. 


When a thread has been started, a new stack is created, with 
the Runnable’s run() method on the bottom of the stack. The 
thread is now in the RUNNABLE state, waiting to be chosen 
to run. 


A thread is said to be RUNNING when the JVM's thread 
scheduler has selected it to be the currently running thread. 
On a single-processor machine, there can be only one 
currently running thread. 


Sometimes a thread can be moved from the RUNNING state 
to a temporarily NON-RUNNABLE state. A thread might be 
blocked because it's waiting for data from a stream, because it 
has gone to sleep, or because it is waiting for an object's lock. 
We'll see locks in the next chapter. 


Thread scheduling is not guaranteed to work in any particular 
way, SO you cannot be certain that threads will take turns 
nicely. 
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Putting a thread to sleep 


One way to help your threads take turns is to put them to 
sleep periodically. All you need to do is call the static sleep() 
method, passing it the amount of time you want the 


| to sleep for, in milliseconds. Puttin g a threa d to 
or example: 2 

Thread. sleep (2000) ; Sleep Sives the other 
will knock a thread out of the running state and keep threads a chance to 


it out of the runnable state for two seconds. The fun. 
thread can’t become the running thread again until 


after at least two seconds have passed. When the thread wakes 


A bit unfortunately, the sleep method throws an e 
InterruptedException, a checked exception, so all calls up : it alway: 5 goes hack 


iS ae suse be es catch (or declared). to the runnable state 
o asleep call really looks like this: . 
and waits for the thread 


try { e 
Thread. sleep (2000) ; scheduler to choose it 
} catch (InterruptedException ex) { 7 
ex.printStackTrace () ; to fun again. 


} 


Now you know that your thread won’t wake up before 
the specified duration, but 1s it possible that it will wake up 
some time a/ler the “timer” has expired? Effectively, yes. The 
thread won’t automatically wake up at the designated time 
and become the currently running thread. When a thread 
wakes up, the thread is once again at the mercy of the thread 
scheduler; therefore, there are no guarantees about how long 
the thread will be out of action. 
It can be hard to understand how much time 
a number of milliseconds represents. There's a 
convenience method on java.util.concurrent. 
TimeUnit that we can use to make a more 
readable sleep time: 


TimeUnit .MINUTES.sleep (2) ; 
which may be easier to understand than: 


Thread.sleep (120000) ; 


(You still need to wrap both in a try-catch, 
though.) 
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Using sleep to make our program Leki rien consistent order 


more predictable 


‘ = . java PredictableSleep 
Remember our earlier example that kept giving us different results 


each time we ran it? Look back and study the code and the sample 
output. Sometimes main had to wait until the new thread finished top o’ the stack 
(and printed “top o’ the stack”), while other times the new thread 
would be sent back to runnable before it was finished, allowing 
the main thread to come back in and print out “back in main.” back in main 

How can we fix that? Stop for a moment and answer this question: top o’ the stack 
“Where can you put a sleep() call, to make sure that “back in main” 
always prints before “top o’ the stack”? 


back in main 


java PredictableSleep 


java PredictableSleep 


back in main 
top o’ the stack 
java PredictableSleep 


class PredictableSleep { back in main 
public static void main (String[] args) { top o’ the stack 
ExecutorService executor = ; ; 

Executors .newSingleThreadExecutor () ; java PredictableSleep 
executor.execute(() -> sleepThenPrint()) ; back in main 
System.out.printin("back in main") ; 
executor. shutdown () ; top o’ the stack 

} 
Instead £ 
oF putti 
private static void sleepThenPrint() { catch inside “ n9 a lambda with an y yd 
ie { meth 7 WE ve put the job : “ie ry— 
ry od. We re éallin th Job Code inside g 
TimeUnit.SECONDS.sleep (2) ; €XPression. 3 the method f, 


rom thi 
} catch (InterruptedException e) { lambda 


e.printStackTrace () ; 


! here will foree the new 
System.out.println("top o’ the stack") ; Calling, slee? - the eurrently ae at 
tnvead 4 ae khread ™" get at 
d There will b dee i oe yack in main 
Thread-sleep() nae a aan (Foy. about fd Pause tegen 
Exception hat we nee ce the Seconds) before 
or declare- Because eee a get to this line, en 


: he \ . “ 
Exception makes tHe a its own vee PP ©’ the 


bit longer, we've put | 
method. 


=) 
Brain Barbell 


Can you think of any problems with forcing your 


threads to sleep for a set amount of time? How 
long will it take to run this code 10 times? 
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There are downsides to forcing 
the thread to sleep 
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@ The program has to wait for at least that amount of time. 


If we put the thread to sleep for two seconds, the thread will be non-runnable for that time. 
When it wakes up, it won’t automatically become the currently running thread. When a thread 
wakes up, the thread is once again at the mercy of the thread scheduler. Our application is go- 
ing to be hanging around for at least those two seconds, probably more. ‘This might not sound 
like a big deal, but imagine a bigger program full of these pauses intentionally slowing down the 
application. 


@ How do you know the other job will finish in that time? 


We put the new thread to sleep for two seconds, assuming that the main thread would be the 
running thread, and complete its work in that time. But what if the main thread took longer to 
finish than that? What if another thread, running a longer job, was scheduled instead? One of 
the ways people deal with this is to set sleep times that are much longer than they’d expect a 
job to take, but then our first problem becomes even more of a problem. 


Is there a way for one thread to tell another 
that it has finished what it's working on? That 
way, the main thread could just wait for that 

signal and then carry on when it knows it's safe 
to go. 


A better alternative: wait for the perfect time. 


What we really wanted in our example was to wait until a specific thing had 
happened in our main thread before carrying on with our new thread. Java 


aw @ supports a number of different mechanisms to do this, like Future, CyclicBarrier, 


Semaphore, and CountDownLatch. 


To coordinate events happening on multiple 
threads, one thread may need to wait for a 
specific signal from another thread hefore it 


can continue. 
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Counting down until ready 
CountDownLatch is a 
harrier synchronizer. 
continuing. You might be counting down until a minimum number of Barri ers are me chanis ms 


clients have connected, or a number of services have been started. 


This is what java.util.concurrent .CountDownLatch is for. to allow threads ie) co- 
You set a number to count down from. Then any thread can tell the latch ordinate with each other. 


to count down when a relevant event has happened. 
In our example, we have only one thing we want to count—our new Other examples are 
thread should wait until the main thread has printed “back in main” Cycli eBarri er an d Phas er 


before it can continue. 


You can make threads count down when significant events have happened. 
A thread (or threads) can wait for all these events to complete before 


import java.util.concurrent.*; 
class PredictableLatch { 
public static void main (String[] args) { lets : This lateh 


US wai : 
ExecutorServic xecutor = Executors.newSingleThreadExecutor () ; We have for the signal.” 


on 
CountDownLatch latch = new CountDownLatch (1) 3 <—$—_—____ to wait Ca we rats 
€ main thread 


xecutor.execute(() -> waitForLatchThenPrint (latch) ) ; ge), So we set 


his up with a value of “)” 
System.out.printlin("back in main"); <s ' 2 at : 


latch. countD ; Doras 9nd 
step -counspown OK Tell the latth to count down whe, the ey aes read 
executor.shutdown (); main method has Printed its message. ° un 0 


} 


private static void waitForLatchThenPrint (CountDownLatch latch) { 


. . goe. | his 
ee await () ; Wait for the main thread te une ny its caitng 
} catch (InterruptedException e) { thread will be in a hanekonne 


e.printStackTrace(); 
} 
System.out.printlin("top o’ the stack"); 
} 


awai 

i, rma ce a an 
‘ ale *€ePtion, which needs to 

or declared. 

} 

The code is really similar to the code that performs a sleep; the main difference is the 
latch.countDown in the main method. The performance difference is significant, though. 
Instead of having to wait at least two seconds to make sure main has printed its message, 
the new thread waits only until the main method has printed its “back in main” message. 


To get an idea of the performance difference this might make on a real system, when 
this latch code was run on a MacBook 100 times, it took around 50 milliseconds to finish 
all one hundred runs, and the output was in the correct order every tame. If running the 
sleep() version just one time takes over 2 seconds (2000 milliseconds), imagine how long it 
took to run 100 times*.... 


* 200331 milliseconds. That’s over 4000x slower. 
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Making and ; 
S 
(or more!) tarting two threads 


What h 
appens if we 
want to s 
tart more than one job in additi 
on to our mat 
n thread? 


Clearl 
Yy, WE can’t us 

e Exe : 
than one cutors.newS 

thread. Wh ingleThre dE 
. What else is avai adExecutor() if 
ilable? if we want to 
* run more 


java.util.concurrent-ExecifO¥ (dust a few of the 
factory methods) 


ExecutorService newCcachedThreadPool() 


Creates a thread pool that creates new threads as needed, but will reuse 
previously constructed threads when they are available. 


ExecutorService newFixedThreadPoollint nthreads) 


Creates a thread pool that reuses a fixed number of threads operating 
offa shared unbounded queue. 


gcheduledExecutorservice newScheduledThreadPool(int corePoolsize) 


Creates a thread pool that can schedule commands to run after a 
given delay, or to execute periodically. 


ExecutorService newsingleThreadexecutort 


Creates an Executor that uses a single worker thread operating off an 
unbounded queue. 


gcheduledExecutorservice ewsinglethreadscheduledExecutor" 


Creates a single-threaded executor that can schedule commands to run 
after a given delay, or to execute periodically. 


ExecutorService newWorkStealingPool() 


Creates a work-stealing thread pool using the number of available processors 
as its target parallelism level. 


These 
Koi masaineen i at can he used (and reused) top kari 
jobs 4o Fen than A t the pool, and what to do if th jobs. 
implementation. ads available, depends on the Exacuortondao 
ice 
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Pooling Threads 


Using a pool of resources, especially ones that are expensive to create like Threads or 
database connections, is a common pattern in application code. 


ove 
is Ca tontain one or ™ ; 
A thread Poe noe aa be added, used, veused 


| 
y ol nd even Killed according & whatever 
he ‘the thread pool was set vP 


When you create a new ExecutorService, its pool 
may be started with some threads to begin with, or 
the pool may be empty. 


You can create an ExecutorService with a thread 
pool using one of the helper methods from the 
Executors class. 

ExecutorService threadPool = 


Th i 
¢ threads available for running jobs. Executors .newCachedThreadPool () ; 
ow many threads are allowed ad how 


they are used is determined by the pool. 


This Thread is idle. 


been 
This Thread hay oe 
¢ sscaned a job ih 


You can use the pool's threads to run your job 
by giving the job to the ExecutorService. The Ex- 
ecutorService can then figure out if there’s a free 
Thread to run the job. 


threadPool.execute(() -> run("Job 1")); 


This means an ExecutorService can reuse threads; 
it doesn’t just create and destroy them. 


‘ read All Th As you give the ExecutorService more jobs to run, 
without a T tads Assigned 3 job it may create and start new Threads to handle the 
“ J jobs. It may store the jobs in a queue if there are 

——— = ; more jobs than Threads. 


How an ExecutorService deals with additional jobs 
depends on how it is set up. 


threadPool.execute(() -> run("Job 324")); 


The ExecutorService may also terminate Threads 
; : == that have been idle for some period of time. This 

New Threads treated to deal can help to minimize the amount of hardware 

with all the new jobs resources (CPU, memory) your application needs. 
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running and closing multiple threads 


Running multiple threads 


The following example runs two jobs, and uses a fixed-sized thread pool to 
create two threads to run the jobs. Each thread has the same job: run in a 
loop, printing the currently running thread’s name with each iteration. 


import java.util.concurrent.ExecutorService; 


import java.util.concurrent.Executors; Cevvite with 3 
(AN ow 
an Exe (we Kn 
public class RunThreads { Great aed unread (4 jobs) 
’ TA to yun 
public static void main(String[] args) { ge weve oer) 


ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 
threadPool.execute(() -> runJob("Job 1")) is ; 
threadPool.execute(() -> runJdob("Job 2")) Re A lambda expression that represents our 


threadPool . shutdown () ; saat a : 4 eee ts 
lambdas, here you'd pass in a new instante 
of your Runnable ¢lass, like we did when we 
public static void runJob(String jobName) { treated MyRunnable earlier in the chapter. 


for (int i= 0; i < 25; i++) { 
String threadName = Thread.currentThread() .getName () ; 
System.out.println(jobName + " is running on " + threadName) ; 


‘rouah this loop 
s oe each Lime- 


} 
} sab is to vun th 
The x A the thread 


prin 


File Edit Window Help Globetrotter 
Part of the output wh | File Edit Window Help Globetrotter 
output when : 
a en ee eres © java RunThreads 


Wh { ill h q Job 1 is running pool-1-thread-1 
a wi appens Job is running pool-1-thread-2 
Will the threads take turns? Will you see the thread Job is running pool-1-thread-2 
names alternating? How often will they switch? With Job is running pool-1-thread-1 
each iteration? After five iterations? Job is running pool-1-thread-2 
You already know the answer: we don’t know! It’s up to Job is running pool-1-thread-1 
the scheduler. And on your OS, with your particular Job is running pool-1-thread-2 
JVM, on your CPU, you might get very different results. Job is running pool-1-thread-1 
Running this on a modern multicore system, the two Job is running pool-1-thread-2 
jobs will likely run in parallel, but there’s no guarantee Job is running pool-1-thread-1 


that this means they will complete in the same amount woo is running pool-1-thread-1 


of time or output values at the same rate. Job 
Job 
Job 
Job 


Job 


is running pool-1-thread-1 
is running pool-1-thread-1 
is running pool-1-thread-1 
is running pool-1-thread-1 


2 
2 
1 
2 
1 
2 
1 
2 
1 
1 
1 
1 
1 
1 
1 


is running pool-1-thread-1 
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Closing time at the thread pool 


You may have noticed that our examples have a threadPool . shutdown() at the end of the 
main methods. Although the thread pools will take care of our individual Threads, we do need 
to be responsible adults and close the pool when we’re finished with it. That way, the pool can 
empty its job queue and shut down all of its threads to free up system resources. 


ExecutorService has two shutdown methods. You can use either, but to be safe we’d use both: 


@ ExecutorService.shutdown() 
Calling shutdown() asks the ExecutorService nicely if it wouldn’t mind awfully wrapping things up 


so everyone Can gO home. 


All of the Threads that are currently running jobs are allowed to finish those jobs, and any jobs 


waiting in the queue will also be finished off. The ExecutorService will reject any new jobs too. 


If you need your code to wait until all of those things are finished, you can use awaitTermination 
to sit and wait until it’s finished. You give await’ Termination a maximum amount of time to wait for 
everything to end, so awaitTermination will hang around until either the ExecutorService has 
finished everything or the timeout has been reached, whichever is earlier. 


@ ExecutorService.shutdownNow() 


Everybody out! When this is called, the ExecutorService will try to stop any Threads that are 
running, will not run any waiting jobs, and definitely won’t let anyone else into the pool. 


Use this if you need to put a stop to everything. This is sometimes used after first calling shutdown() 
to give the jobs a chance to finish before pulling the plug entirely. 


Create 
at 
: ae hread Pool with just 
public class ClosingTime { Just. two 
public static void main(String[] args) { 
ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 


WO | 
LorService threadPool.execute (new LongJob ("Long Job") ) ; ihe - n 
Ask dhe Exetv if you call threadPool.execute (new ShortJob("Short Job") ) ;)¥© YF uses a sleep 80 it can 


threads. 


that 
to ghut. down ob wee be a long-running 
exeeucel, wee tt get a threadPool . shutdown () ; ei and ChortvJeb are 
alter Ee eeubion Het AZ Dalat tbat implement Runnable?- 
evel wee WN try { 
al, oA Exebuterser ke jes boolean finished = threadPool.awaitTermination(5, TimeUnit.SECONDS) ; 
continue tT Y" “4 cun ar) System. out.println("Finished? " + finished) ; Wait 
{nat are on } catch (InterruptedException e) { Ex. 7: SeConds ip th 
wartindg, jobs . e.printStackTrace () ; i ne to Finish ‘ 
Ind. . 
en . shutdownNow () ; the oe Pa: i its 
} “ve tell the ExetutorService to stop has finished, it vet, everythin 
} At this point, we tell C sything w3s already shut urns “False.” 
everything right now: | on } "9 thing 
down, that’s Line; this won t Go 
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aren’t threads wonderful? 


Wow! Threads are 
the greatest thing since the 
MINI Cooper! I can't think 
of a single downside to using 
threads, can you? 


Um, yes. There IS a dark side. 
Multithreading can lead to 


concurrency “issues.” 


Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear...you 
know the rest. 


It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object’s data. In other 
words, methods executing on two different stacks are both 
calling, say, getters or setters on a single object on the heap. 


It’s a whole “left-hand-doesn’t-know-what-the-right-hand- 
is-doing” thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the One True Thread. The only one 
that matters. After all, when a thread is not running, and in 
runnable (or blocked) it’s essentially knocked unconscious. 
When it becomes the currently running thread again, it 
doesn’t know that it ever stopped. 
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_— BULLET POINTS 


The static Thread.sleep() method forces 
a thread to leave the running state for at 
least the duration passed to the sleep 
method. Thread.sleep(200) puts a thread 
to sleep for 200 milliseconds. 


You can also use the sleep method on 
java.util.concurrent. TimeUnit, for example 
TimeUnit. SECONDS. sleep(2). 


The sleep() method throws a checked 
exception (InterruptedException), so all 
calls to sleep() must be wrapped in a try/ 
catch, or declared. 


There are different mechanisms to give 
threads a chance to wait for each other. 
You can use sleep(), but you can also 
use CountDownLatch to wait for the right 
number of events to have happened 
before continuing. 


Managing threads directly can be a lot 

of work. Use the factory methods in 
Executors to create an ExecutorService, 
and use this service to run Runnable jobs. 


Thread pools can manage creation, reuse, 
and destruction of threads so you don’t 
have to. 


ExecutorServices should be shut down 
correctly so the jobs are finished and 
threads terminated. Use shutdown() for 
graceful shutdown, and shutdownNow() to 
kill everything. 


\ It’s a cliff-hanger! 
A dark side? Race condi- 
tions?? Data corruption?! 
But what can we DO about 
those things? Don't leave us 
hanging! 


Stay tuned for the next chapter, where we address 
these issues and more... 
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= 
Exercise 


A bunch of Java and network terms, in full costume, are playing 

a party game, “Who am |?” They'll give you a clue—you try to 
guess who they are based on what they say. Assume they always 
tell the truth about themselves. If they happen to say something 
that could be true for more than one attendee, then write down 

all for whom that sentence applies. Fill in the blanks next to the 
sentence with the names of one or more attendees. 


IP 


Tonight’s attendees: 


InetSocketAddress, SocketChannel, IP address, host name, 
port, Socket, ServerSocketChannel, Thread, thread pool, 
Executors, ExecutorService, CountDownLatch, Runnable, 
InterruptedException, Thread.sleep() 


| need to be shut down or | might live forever 
| let you talk to a remote machine 


| might be thrown by sleep() and await() 


If you want to reuse Threads, you should use me 


You need to know me if you want to connect to another 
machine 


I’m like a separate process running on the machine 
| can give you the ExecutorService you need 
You need one of me if you want clients to connect to me 


| can help you make your multithreaded code more 
predictable 


| represent a job to run 


| store the IP address and port of the server 


——— Answers on page 636. 
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final chat client 


New and improved SimpleChatClient 


Way back near the beginning of the chapter, we built the SimpleChatClient that could send outgoing 
messages to the server but couldn’t receive anything. Remember? That’s how we got onto this whole 
thread topic in the first place, because we needed a way to do two things at once: send messages to 
the server (interacting with the GUI) while simultaneously reading incoming messages from the server, 
displaying them in the scrolling text area. 


This is the New Improved chat client that can both send and receive messages, thanks to the power of 
multithreading! Remember, you need to run the chat server first to run this code. 


import javax.swing.*; 


import java.awt.*; Yes, there really [S an 
import java.awt.event.*; Si to this chapter. 
import java.io.*; ut not yet. 


import java.net. InetSocketAddress; 
import java.nio.channels.*; 
import java.util.concurrent.*; 


import static java.nio.charset.StandardCharsets.UTF_ 8; 


public class SimpleChatClient { 
private JTextArea incoming; 
private JTextField outgoing; 
private BufferedReader reader; 
private PrintWriter writer; 


public void go() { 


setUpNetworking() ; 
) 
: tode you Ve er 
JScrollPane scroller = createScrollableTextArea () ; bh ‘s rat apes ue 4 ee 
before. Nothing To we ave 
outgoing = new JTextField(20) ; highlighted y aa d 
ag “reader thvrea 


JButton sendButton = new JButton ("Send") ; 
sendButton.addActionListener(e -> sendMessage() ) ; 


JPanel mainPanel = new JPanel() ; We've got a new job . 
mainPanel .add(scroller) ; élass, chick nak » an inner 
mainPanel .add (outgoing) ; The ch x i a ee 
mainPanel.add(sendButton) ; . ee aes, la 
ream, 


dis i . ; 
ExecutorService executor = Executors.newSingleThreadExecutor () ; reying any indomin 


mes ; : 
executor .execute (new IncomingReader () ) ; i ie in the serollin 
text area. We start the 
JFrame frame = new JFrame("Ludicrously Simple Chat Client") ; ceete a single thread 
frame.getContentPane() .add(BorderLayout.CENTER, mainPanel) ; enya since we know we 
frame.setSize(400, 350) ; run only this one job. 


frame.setVisible (true) ; 
frame .setDefaultCloseOperation (WindowConstants .EXIT_ON_CLOSE) ; 
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private JScrollPane createScrollableTextArea() { ied like we 
incoming = new JTextArea(15, 30); \ helper me i ay ~ 15, 
incoming .setLineWrap (true) ; saw back in Chay fa at, avea- 
incoming .setWrapStyleWord (true) ; ereate a strolling te 
incoming .setEditable (false) ; 
JScrollPane scroller = new JScrollPane (incoming) ; 


scroller.setVerticalScroll1BarPolicy (ScrollPaneConstants.VERTICAL SCROLLBAR_ALWAYS) ; 


scroller.setHorizontalScrollBarPolicy (ScrollPaneConstants .HORIZONTAL SCROLLBAR_NEVER) ; 
return scroller; 


} 


private void setUpNetworking() { 


} 


private void sendMessage() { 


} 


try { 


InetSocketAddress serverAddress = new InetSocketAddress("127.0.0.1", 5000); 
SocketChannel socketChannel = SocketChannel.open(serverAddress) ; 


reader = 
writer = 


new BufferedReader (Channels .newReader (socketChannel, UTF_8)); 
new PrintWriter (Channels.newWriter(socketChannel, UTF_8)); 


a new reader 


treate 
System.out.println("Networking established.") ; Channels te 


) 
: s 
We're using LChannel that 
} catch (IOException ex) { gnd writer for the ee writer sends 
ex.printStackTrace () ; tonnette to the ett aoe we've Using) 
server) . 
} messages +0 ce the reader jot 


nat 
reader so {) , 
oe vom the server 


writer .printlin (outgoing. getText()); 


writer. flush () ; Nothing new here. When the user ¢élicks 
outgoing.setText ("") ; the send button, this method sends the 
outgoing. requestFocus () ; contents of the text field to the Sevier: 


public class IncomingReader implements Runnable { 


} 


public void run() { 
String message; 


try { ig what the thread does!! 
while ((message = reader.readLine()) != null) { hoe unl) method, it stays in 3 


System.out.printlin ("read " + message) ; iy the Lit he Crom 
incoming.append(message + "\n") ; loop (as long as wha ; dint : 
} the server is no null : eath line 
} catch (IOException ex) { line ata Lime and ad We (along 
ex.printStackTrace () ; ko the strolling text are 


} tharacter)- 


with a new line 
} 


public static void main(String[] args) { 


} 


new SimpleChatClient() .go(); 


Remember, the Chat Server code was 
the Ready-Bake Code from page 606. 
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exercise: code magnets 


634 


———> Answers on page 636. 
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Code Magnets 


A working Java program is scrambled up on the fridge (see 
the next page). Can you reconstruct the code snippets on the 
next page to make a working Java program that produces the 
output listed below? 


To get it to work, you will need to be running the 
SimpleChatServer from page 606. 


% java PingingClient 
Networking established 
09:27:06 Sent ping 0 
09:27:07 Sent ping 
09:27:08 Sent ping 
09:27:09 Sent ping 


09:27:10 Sent ping 
09:27:11 Sent ping 
09:27:12 Sent ping 
09:27:13 Sent ping 
09:27:14 Sent ping 
09:27:15 Sent ping 


woot nou F&F WN FE 
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Code Magnets, continued 


import java.io.*; 
import java.net.InetSocketAddress; 
import java.nio.channels.*; 

import java.time.format.FormatStyle; 
import java.util.concurrent.TimeUnit; 


for (int i = 0; i < 10; i++) { 


Ss Mm. . Ae + Ss + message 7 
Sy te out Println(currentt me ent 
) , 


InetSocketAddress server 


new TnetSocketAddress(" 


System.out.println("Networking established"); | 
public static void main(String [] args) : 


LocalizedTime(FormatStyle 


127.0.0.1", 5000); 


TimeUnit.SECONDS.sleep(1); 


.MEDIUM) ); 


String currentTime = now()- format (of 
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exercise solutions 


Who Am I? (from page 631) 


| need to be shut down or | might 


| let you talk to a remote machine 


live forever ExeeutorService Exercise SOLUEIONS 
SoeketChannel, Socket 


| might be thrown by sleep() and await() InterruptedException 

If you want to reuse Threads, you should use me Thread pool, ExeeutorService 
You need to know me if you want to connect to another machine |[P Addvess, ttost name, port 
I’m like a separate process running on the machine Thread 

| can give you the ExecutorService you need Exeeutors 

You need one of me if you want clients to connect to me ServerSoeketChannel 


| can help you make your multithreaded code more predictable Thread.sleep(), CountDownLateh 


| represent a job to run Runnable 

| store the IP address and port of the server InetSoeket Address 
import java.io.*; 
import java.net.InetSocketAddress ; C d M t 
import java.nio.channels.*; oae agne s 
import java.time.format.FormatStyle; (from pages 634-635) 


import java.util.concurrent.TimeUnit; 


import static j 
import static j 
import static j 


ava.nio.charset.StandardCharsets.UTF_8; 
ava.time.LocalDateTime.now; 
ava.time.format.DateTimeFormatter.ofLocalizedTime; 


public class PingingClient { 


public static void main(String[] args) { 
InetSocketAddress server = new InetSocketAddress ("127.0.0.1", 5000) ; 
try (SocketChannel channel = SocketChannel.open(server)) { 
PrintWriter writer = new PrintWriter(Channels.newWriter(channel, UTF_8)); 
System.out.println("Networking established") ; ¢ getting the 


‘ ay Sica tt: 
This is one by ino) 
for (int i = 0; i < 10; i++) { ape Lyne a toe : 
novld ek ban String message = "ping " + i; ante 3 String, Setonds 
You S| out even * ) q, Wet tSe.peinein (message) ; ak Yours: Minutes 
same ove the cleegl writer .flush() ; 
uae ere else inside String currentTime = now() .format (ofLocalizedTime (FormatStyle.MEDIUM) ) ; 
some System.out.println(currentTime + " Sent " + message) ; 
his for \oo? Y 
thi TimeUnit . SECONDS. sleep (1) ; 
} ) cg 
} catch (IOException | InterruptedException e) { terryps h the 
Slee 6) d ed xe 
e.printStackTrace () ; P insid €Ptio t 
, _ Can Cate, of the for | brown b 
} Catching all Exceptions a end of 4) all th. Een °2P, oe y 
Khe end because we do the € method ‘Ptions Ps 
} r ith them all. : the 
same thing wi 
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x K 
x Code Kitchen Your message ets sent i 


*% pattern when Yo" we 


|@e@ Cyber BeatBox 


Bass Drum 
Closed Hi-Hat 

Open Hi-Hat 

Acoustic Snare 

Crash Cymbal 

Hand Clap sendlt 
High Tom 

Hi Bongo 

Maracas 
Whistle 

Low Conga 

Cowbell 

Vibraslap MorganMove: groove2 revised 
Low-mid Tom 


Tempo Up 


Tempo Down 


dance beat 


SamSampler: groove #2 


BoomTish: dance beat 
High Agogo 


Open Hi Conga 


"essages f, 
Now you've seen how to build a chat client, we have P ras one to re 
the last version of the BeatBox! Wie. that goes 
i. » and then liek 
It connects to a simple MusicServer so that you can lay it. 


send and receive heat patterns with other clients. 


The code is really long, so the complete listing Thy 
actually in Appendix A. 
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18 race conditions and immutable data 


Dealing with 
Concurrency Issues 


Dave hasn't noticed 
that Helen is taking bites out of 
his sandwich while he's eating it! 
Those two should figure out they're 
sharing something, or it's going to 
get messy... 


Doing two or more things at once is hard. writing multithreaded code is 
easy. Writing multithreaded code that works the way you expect can be much harder. In this 
final chapter, we're going to show you some of the things that can go wrong when two or more 
threads are working at the same time. You'll learn about some of the tools in java.util.concurrent 
that can help you to write multithreaded code that works correctly. You'll learn how to create 
immutable objects (objects that don’t change) that are safe for multiple threads to use. By the 


end of the chapter, you'll have a lot of different tools in your toolkit for working with concurrency. 


this isanew chapter 639 


concurrency issues 


What could possibly go wrong? 


At the end of the last chapter we hinted that things may not all be rainbows and sunshine when you’re 
working with multithreaded code. Well, actually, we did more than hint! We outright said: 


640 


“It all comes down to one potentially deadly 
scenario: two or more threads have access to a 
single object’s data.” 
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S \ 


Why is it a problem if two threads are both 
reading and writing? 


If a thread reads the object's data before changing 
it, why is ita problem that another thread might 
also be writing at the same time? 


race conditions and immutable data 


Marriage in Trouble. 


Can this couple be saved? . 4 


Next, on a very special Dr. Steve Show ee} a 
: ? 4 


f 


[Transcript from episode #42] 


Welcome to the Dr. Steve show. 


We've got a story today that’s centered around one of the top reasons why 
couples split up—finances. 


Today’s troubled pair, Ryan and Monica, share a bank account. But not for 
long if we can’t find a solution. The problem? The classic “two people—one 
bank account” thing. 


Here’s how Monica described it to me: 


“Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to spend money must check the 
balance in the account before withdrawing cash or spending on a card. 
It all seemed so simple. But suddenly we’re getting hit with ‘ 
overdraft fees! et 


I thought it wasn’t possible; I thought our procedure was safe. 
But then this happened: 


Ryan had a full online shopping cart totalling $50. He checked the balance 
in the account and saw that it was $100. No problem. So he started the 
checkout procedure. 


And that’s where Icome in; while Ryan was filling in the shipping details, I Ryan and Monica: victims 
wanted to spend $100. I checked the balance, and it’s $100 (because Ryan the “two People, one 
hasn’t clicked the “Pay” button yet), so I think, no problem. So I spend account” Problem. 

the money, and again no problem. But then Ryan finally pays, and we’re 

suddenly overdrawn! He didn’t know that I was spending money at the 

same time, so he just went ahead and completed his transaction without 

checking the balance again. You’ve got to help us, Dr. Steve!” 


Is there a solution? Are they doomed? We can’t help them with their 
online shopping addiction, but can we make sure one of them can’t start 
spending while the other one is shopping? 


Take a moment and think about that while we go to a commercial break. 
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Ryan and Monica code 


The Ryan and Monica problem, in code 


The following example shows what can happen when éwo threads 
(Ryan and Monica) share a single object (the bank account). 


The code has two classes, BankAccount and RyanAndMonicaJob. 
There’s also a RyanAndMonicaTest with a main method to run 
everything, The RyanAndMonicaJob class implements Runnable, 
and represents the behavior that Ryan and Monica both have— 
checking the balance and spending money. 


Runnable 


BankAccount 


The RyanAndMonicaJob class has instance variables for the shared 


BankAccount, the person’s name, and the amount they want to int balance 


getBalance() 
spend() 


spend. The code works like this: 


@) Make an instance of the shared bank account 
Creating a new one will set up all the defaults correctly. 


BankAccount account = new BankAccount() ; 


@ Make one instance of RyanAndMonicaJob for each 
person 


We need one job for each person. We also need to give them 
access to the BankAccount and tell them how much to spend. 


RyanAndMonicaJob 


BankAccount account 
String name 
int amountToSpend 


run() 
goShopping() 


RyanAndMonicaJob ryan = new RyanAndMonicaJob("Ryan", account, 50); 
RyanAndMonicaJob monica = new RyanAndMonicaJob("Monica", account, 100) ; 


8) Create an ExecutorService and give it the two jobs 


Since we know we have two jobs, one for Ryan and one for Monica, we can 
create a fixed-sized thread pool with two threads. 


ExecutorService executor = Executors.newFixedThreadPool (2) ; 
executor .execute (ryan) ; 
executor .execute (monica) ; 


@ Watch both jobs run 


One thread represents Ryan, the other represents Monica. Both threads 
check the balance before spending money. Remember that when more than 
one thread is running at a time, you can't assume that your thread is the 
only one making changes to a shared object (e.g., the BankAccount). Even 
if there's only two lines of code related to the shared object, and they're 
right next to each other. 


if (account.getBalance() >= amount) { 
account. spend (amount) ; 

} else { 
System.out.printlin("Sorry, not enough money") ; 


} 


642 chapter 18 


In the goShopping() 
method, do exactly 
what Ryan and Monica 
would do—check the 
balance and, if there’s 
enough money, spend. 


This should protect 
against overdrawing 
the account. 


Except...if Ryan and 
Monica are spending 
money at the same 
time, the money in the 
bank account might be 
gone before the other 
one can spend it! 


race conditions and immutable data 


The Ryan and Monica example stance of the 


import java.util.concurrent.*; There will be only ONE sh both threads 
Aetount: That means Make two ; 
public class RyanAndMonicaTest { Bar fhis one account: that two jobs 
public static void main(String[] args) { will access me will do the 
BankAccount account = new BankAccount() ; oe withdrawal Fein 
RyanAndMonicaJob ryan = new RyanAndMonicaJob("Ryan", account, 50) the shared bank 


RyanAndMonicaJob monica = new RyanAndMonicaJob("Monica", account, 100) ;d¢Count, one foy- 
ExecutorService executor = Executors.newFixedThreadPool (2) ; Monieg Sa f 
executor .execute (ryan) ;<— Start both one toy 


executor .execute (monica) ;e Funning, Jobs Cres J, yan, Passing in the 
executor. shutdown () ; € d new thread mount they've Joing 
' 4 Lorget to shut the pool down: Pool with two to spend. 
} Dont ord threads f ie 
Jobs. 


class RyanAndMonicaJob implements Runnable { 
private final String name; 
private final BankAccount account; 
private final int amountToSpend; 
RyanAndMonicaJob(String name, BankAccount account, int amountToSpend) { 
this.name = name; 
this.account = account; 
this.amountToSpend = amountToSpend; 
} ina) 
«et galls goShoPpPing 
The vant) method just b) 


the amount they need to spend: 


public void run() { 
goShopping (amountToSpend) ; with 
} 


ae ) 
Cheek the acount balante, and if there's 
private void goShopping(int amount) { 


head and spend the 
if (account.getBalance() >= amount) { _————a enough meee we Se'¢ ; M oid 
System.out.println(name + " is about to spend"); money, just like Ryan an jon 


account. spend (amount) ; 
System.out.println(name + " finishes spending") ; , 
Y P ( P g") We put in a bunch of vin 
} else { sisi, Prin 
System.out.println("Sorry, not enough for " + name) ; ements So we Can see 
} whats happening as it runs. 


} 


class BankAccount { f starts with a 
private int balance = 100; <——— The attoun 100. 
public int getBalance() { balance ov | 
return balance; 
} 
public void spend(int amount) { 
balance = balance - amount; 
if (balance < 0) { 
System.out.println("Overdrawn!") ; 


} 
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Ryan and Monica output 


How did this 
happen’ 


File Edit Window Help Visa 


% java RyanAndMonicaTest 


Ryan is about to spend 
Monica is about to spend 
Overdrawn! 

Ryan finishes spending 


Monica finishes spending 


This code is not deterministic: it 
doesn’t always produce the same result 
every time. You may need to run it a 
few times hefore you see the problem. 


This is common with multithreaded 
code, since it depends upon which 
threads start first and when each 
thread gets its time on a CPU core. 


Cometimes the 


code wor 
t orvettly and 
they don't 9¢ 


overdrawn 
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File Edit Window Help WorksOnMyMachine 


% java RyanAndMonicaTest 


Ryan is about to spend 


Ryan finishes spending 


Sorry, not enough for Monica 


The goShopping() method 
always checks the balance 
before making a withdrawal, 
but still we went overdrawn. 


Here’s one scenario: 


Ryan checks the balance, sees that 
there’s enough money, and goes to check 
out. 


Meanwhile, Monica checks the balance. 
She, too, sees that there’s enough money. 
She has no idea that Ryan is about to pay 
for something. 


Ryan completes his purchase. 


Monica completes her purchase. Big 
Problem! In between the time when 
she checked the balance and spent the 
money, Ryan had already spent money! 


Monica’s check of the account was 
not valid, because Ryan had already 
checked and was still in the middle of 
making a purchase. 


Monica must be stopped from getting into 
the account until Ryan has finished, and 
vice versa. 


race conditions and immutable data 


They need a lock for account access! 


The lock works like this: 


@) There's a lock associated with the bank 


account transaction (checking the balance 
and withdrawing money). There's only 

one key, and it stays with the lock until 
somebody wants to access the account. 


When Ryan wants to access the bank 
account (to check the balance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else can access 
the account, since the key is gone. 


Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so Monica can't access the account 
until Ryan unlocks the account and returns 
the key. 


Now, even if Ryan gets distracted after 

he checks the balance, he has a guarantee 
that the balance will be the same when he 
spends the money, because he kept the key 
while he was doing something else! 


The bank account 
transaction is 
unlocked when 
nobody is using 
the account. 


When Ryan 

wants to access 
the account, he 
secures the lock 
and takes the key. 


When Ryan is 
finished, he 
unlocks the lock 
and returns the 
key. Now the key 
is available for 
Monica (or Ryan 
again) to access 
the account. 
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using synchronized 


We need to check the balance and spend 
the money as one atomic thing Ry 


We need to make sure that once a thread starts a shopping transaction, 7 
must be allowed to finish before any other thread changes the bank account. 


In other words, we need to make sure that once a thread has checked the 
account balance, that thread has a guarantee that it can spend the money 
before any other thread can check the account balance! 


Use the synchronized keyword on a method, or with an object, to 
lock an object so only one thread can use it at a time. 


That’s how you protect the bank account! We can put a lock on the bank 
account inside the method that does the banking transaction. That way, 
one thread gets to complete the whole transaction, start to finish, even if 
that thread is taken out of the “running” state by the thread scheduler or 
another thread is trying to make changes at exactly the same time. 


On the next couple of pages we'll look at the different things that we can 
lock. With the Ryan and Monica example, it’s quite simple—we want to 
wrap our shopping transaction in a block that locks the bank account: 


private void goShopping(int amount) { 
synchronized (account) { 
if (account.getBalance() >= amount) { 


account. spend (amount) ; 


else { 


System.out.println(name + " is about to spend") ; 
System.out.printlin(name + " finishes spending") ; 


System.out.println("Sorry, not enough for " + name); 


The synchronized 
keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 


To protect your data 
(like the bank account), 
synchronize the code 
that acts on that data. 


there are no 


Dumb Questions 


CF Why don’t you just synchronize all the getters and 


(Note for You physi¢s—savvy readers: yes, the 
convention of using the word “atomie’ here 

does not reflect the whole subatomic particle 
thing. Think Newton, not Einstein, when you hear 
the word “atomic” in the context of threads 

or transactions. Hey, it’s not OUR Convention. 

If WE were in charge, we'd apply Heisenbera’s 
Uncertainty Principle to pretty much everything 
related to threads.) 
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setters from the class with the data you're trying to protect? 


A: Synchronizing the getters and setters isn’t enough. 
Remember, the point of synchronization is to make a specific 
section of code work ATOMICALLY. In other words, it’s not 
just the individual methods we care about; it’s methods that 
require more than one step to complete! 


Think about it. We added a synchronized block inside the 
goShopping() method. If getBalance() and spend() were both 
synchronized instead, it wouldn't help—Ryan (or Monica) 
would have checked the balance returned the key! The whole 
point is to keep the key until both operations are completed. 


Using an objects lock 


Every object has a lock. Most of the time, the lock 
is unlocked, and you can imagine a virtual key 
sitting with it. Object locks come into play only 
when there is a synchronized block for an object 


(like in the last page) or a class has synchronized 
methods. A method is synchronized if it 
has the synchronized keyword in the method 
declaration. 


When an object has one or more 
synchronized methods, a thread can 
enter a synchronized method only 
if the thread can get the key to the 
object’s lock! 


The locks are not per method, they are per object. 
If an object has two synchronized methods, 

it doesn’t only mean two threads can’t enter 

the same method. It means you can’t have 

two threads entering any of the synchronized 
methods. If you have two synchronized methods on the 
same object, method1() and method2(), if one thread is in 
method 1(), a second thread can’t enter method1(), obviously, 
but it also can’t enter method2(), or any other synchronized 
method on that object. 


Think about it. If you have multiple methods that can 
potentially act on an object’s instance variables, all those 
methods need to be protected with synchronized. 


The goal of synchronization is to protect critical data. But 
remember, you don’t lock the data itself} you synchronize the 
methods that access that data. 


So what happens when a thread is cranking through its call 
stack (starting with the run() method) and it suddenly hits a 
synchronized method? The thread recognizes that it needs 
a key for that object before it can enter the method. It looks 
for the key (this is all handled by the JVM; there’s no API in 
Java for accessing object locks), and if the key is available, 
the thread grabs the key and enters the method. 


From that point forward, the thread hangs on to that key 
like the thread’s life depends on it. The thread won’t give up 
the key until it completes the synchronized method or block. 
So while that thread is holding the key, no other threads can 
enter any of that object’s synchronized methods, because the 
one key for that object won’t be available. 


Hey, this object's 
takeMoney() method is 
synchronized. I need to get 
this object's key before I 
can go in... 


race conditions and immutable data 


Every Java object has a lock. 
A lock has only one key. 


Most of the time, the lock is 
unjocked and nobody cares. 


But sf an object has 
synchronized methods, a 
thread can enter one of the 
synchronized methods ONLY 
if the key for the object’s lock 
18 available. In other words, 
only if another thread hasn't 
already grabbed the one key. 
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using synchronized 
Using synchronized methods 


Can we synchronize the goShopping() method to fix Ryan and Monica’s problem? 


private synchronized void goShopping(int amount) { 
if (account.getBalance() >= amount) { 
System.out.println(name + " is about to spend") ; 
account . spend (amount) ; 
System.out.println(name + " finishes spending") ; java RyanAndMonicaTest 
} else { 
System.out.println("Sorry, not enough for " + name); |B Si yeWeei-jer-l fo) bh am ody ol—yelel 
} 


; Ryan finishes spending 


Monica is about to spend 


It does NOT work! Overdrawn! 
—_ 


Monica finishes spending 


The synchronized keyword locks an object. ‘The goShopping() method 1s in RyanAnd- 
MonicaJob. Synchronizing an instance method means “lock és RyanAndMonicaJob 
instance.” However, there are éwo instances of RyanAndMonicaJob; one 1s “ryan,” 
and the other is “monica.” If “ryan” is locked, “monica” can still make changes to 
the bank account; she doesn’t care that the “ryan” job is locked. 


The object that needs locking, the object these two threads are fighting over, is the 
BankAccount. Putting synchronized on a method in RyanAndMonicaJob (and lock- 
ing a RyanAndMonicaJob instance) isn’t going to solve anything. 
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race conditions and immutable data 


It’s important to lock the correct object 


Since it’s the BankAccount object that’s shared, you could argue it should be the BankAccount that’s in 
charge of making sure it is safe for multiple threads to use. The spend() method on BankAccount could 


make sure there’s enough money and debit the account in a single transaction. 


class RyanAndMonicaJob implements Runnable { 


// ...vest of the RyanAndMonicaJob class 
// the same as before... 2a be heck 
e 
longer nett ik we 
private void goShopping(int amount) { 1S would "pekore spendin Q) 


System.out.println(name + " is about to spend"); {he Walant saknecount — 


account.spend(name, amount) ; \now h es Lor us: 
System.out.println(name + " finishes spending") ; method alia 
} 
} 
Loek 
class BankAccount { : 7 the 
instay, th mk ACcound 


Ba 
// other methods in BankAccount... ce e 
Se “Sing. “~ threads 


public synchronized void spend(String name, int amount) { 


if (balance >= amount) { T 
balance = balance - amount; a Monita gHOoULD \d 
(balance < 0) { Ryan - awn Now) this i 


ot if 4 
oN 4 " ny. : 
>I 5 System. out.printin ("Overdrawn! i — : me be the ease 


} else { 


System.out.println("Sorry, not enough for " + name) ; thes are no 


Dumb Questions 


Cy What about protecting static variable state? If you 
have static methods that change the static variable state, 


in tull Y only one thread ah oe can you still use synchronization? 


A: Yes! Remember that static methods run against the 
class and not against an individual instance of the class. 

So you might wonder whose object's lock would be used 
ona static method? After all, there might not even be any 
instances of that class. Fortunately, just as each object has 
its own lock, each loaded class has a lock. That means if you 
have three Dog objects on your heap, you have a total of 
four Dog-related locks; three belonging to the three Dog 
instances, and one belonging to the Dog class itself. When 
you synchronize a static method, Java uses the lock of the 
class itself. So if you synchronize two static methods ina 
single class, a thread will need the class lock to enter either 
of the methods. 
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synchronization matters 


The dreaded “Lost Update” problem 


Here’s another classic concurrency problem. Sometimes you'll hear them called “race conditions,” 
where two or more threads are changing the same data at the same time. It’s closely related to the 
Ryan and Monica story, so we'll use this example to illustrate a few more points. 


The lost update revolves around one process: 
Step 1: Get the balance in the account 
int i = balance; Less 
wid RO 
Step 2: Add 1 to that balance Pr doaboly not an 
balance = i+ 1; 


Even if we used the more common syntax of balance++, there is no guarantee that the 
compiled bytecode will be an “atomic process.” In fact, it probably won’t—1t’s actually multiple 
operations: a read of the current value and then adding one to that value and setting it back into 
the original variable. 


In the “Lost Update” problem, we have many threads trying to increment the balance. ‘Take a look 


at the code, and then we’ll look at the real problem: Create ® Lnvread ere 
I Boe jobs: IF YY cee even 
reads here> i lef a 
saat es- 
public class LostUpdate { more Missing vy 


public static void main(String[] args) throws InterruptedException { 
ExecutorService pool = Executors.newFixedThreadPool (6) ; nr a 


Run 1,000 
Balance balance = new Balance() ; : attem ts to 
for (int i = 0; i < 1000; it+) ¢ § the balance, on Ft a bake 
pool.execute(() -> balance.increment () ) ; eads. 


} 


pool .shutdown () ; ol has Linished 


if ( : . . ‘ : ee sure the fo before 
pool.awaitTermination(1, TimeUnit.MINUTES)) { @— Make \\ the uv dates 
System.out.println("balance = " + balance.balance) ; runnin the final eee ’ \f 
; eINTIN, hould be 10% 
’ theory} a rie that. we ve 'o 
} its any | 
an veda 
class Balance { H 
int balance = 0; as Crucial Part/ We ine 
a 5 ! i 
public vord snceemett() { THE Tin to whateve, the nee the balance 
balancet+; whatey A WE READ IT ica of balance was AT 
} er th e : 
5 that po CURRENT vale ig) ypnit adding |, 
an atomic o Ou might think 


Peration, but it is not. 
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race conditions and immutable data 


Let’s run this code... 


@) Thread A runs for a while 


Reads balance: 0 
Set the value of balance to 0 + 1. 
Now balance is 1 


Reads balance: 1 
Set the value of balance to 1 + 1. 
Now balance is 2 


@ Thread B runs for a while 
A Reads balance: 2 


b= Set the value of balance to 2 + 1. 


Now balance is 3 


Reads balance: 3 


[now thread B is sent back to runnable, 
before it sets the value of balance to 4] 


@) Thread A runs again, picking up where it left of f 


Reads balance: 3 
Set the value of balance to 3 + 1. 
Now balance is 4 


i) 


Reads balance: 4 
Set the value of balance to 4 + 1. 
Now balance is 5 


We lost the last updates 
that Thread A made! 
Thread B had previously 
done a “read” of the value 
ta Set the value of balance to 3 + 1. of balance, and when B 


es ; 
a3 Now balance is 4_ ae l woke up, it just kept going 
Yikes! : as if it never missed a beat. 


Thread A updated it to 9, but 
now B came back and stepped 
on toP of the update fh made, 
as if A’s update never happened. 


@) Thread B runs again, and picks up exactly where it left of f! 
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synchronizing methods 


Make the increment() method atomic. 


Synchronize it! 


Synchronizing the increment() method solves the “Lost Update” 


problem, because it keeps the steps in the method (read of balance 


and increment of balance) as one unbreakable unit. 


public synchronized void increment() { 


balancett; 


| x 


i > thi ks like 
Classi¢ conturrency gotcha: this lool 
a gale operation, but it’s actually more 
than one—it’s a vead of the balance, an 
imtrement) and an update to the balance. 


there, are_no 


Dumb Questions 


Q: Sounds like it’s a good idea to synchronize 
everything, just to be thread-safe. 


A: Nope, it’s not a good idea. Synchronization doesn't 
come for free. First, a synchronized method has a certain 
amount of overhead. In other words, when code hits a 
synchronized method, there's going to be a performance hit 
(although typically, you'd never notice it) while the matter of 
“is the key available?” is resolved. 


Second, a synchronized method can slow your program 
down because synchronization restricts concurrency. In 
other words, a synchronized method forces other threads to 
get in line and wait their turn. This might not be a problem 
in your code, but you have to consider it. 


Third, and most frightening, synchronized methods can lead 
to deadlock! (We'll see this in a couple of pages.) 


A good rule of thumb is to synchronize only the bare 
minimum that should be synchronized. And in fact, you 

can synchronize at a granularity that’s even smaller than a 
method. Remember, you can use the synchronized keyword 
to synchronize at the more fine-grained level of one or more 
statements, rather than at the whole-method level (we used 
this in our first solution to Ryan and Monica's problem). 
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Once a thread enters 
the method, we have 

to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 


doStuff() doesn't need to 
be synchronized, so we don't 
synchronize the whole method. 


public void go() { 
doStuff () ; 


synchronized(this) { 


criticalStuff () ; 


moreCriticalStuff () ; 


\ 


Although there are other ways to 


will almost alwa . 
object (this). sa —s 


lock if the whole metho, 


do it, You 
he current 
ie Sdme object you'd 

d were synchronize d. 


Now, only these 4 
into one atomie hers prea th are 
ae imal WITHIN aia 
nn a method declarat 
ee fg Provide an argument iid a 
eee whose key the thread needs to ae 


race conditions and immutable data 


@) Thread A runs for a while 


Attempt to enter the increment() method. 


The method is synchronized, so get the key for this object 


Reads balance: 0 

Set the value of balance to 0 + 1. 

Now balance is 1 

Return the key (it completed the increment() method). 
Re-enter the increment() method and get the key. 
Reads balance: 1 


[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 


@ Thread B is selected to run 


Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 


The key is not available. 


@) Thread A runs again, picking up where it left of f 
(remember, it still has the key) 


Set the value of balance 1 + 1. 
Now balance is 2 


Return the key. 


[now thread A is sent back to runnable, but since it 
has completed the increment() method, the thread 
does NOT hold on to the key] 


@ Thread B is selected to run 


5 Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 


This time, the key IS available; get the key. 
Reads balance: 2 


[continues to run...] 


[now thread B is sent into an “object lock not available” lounge] 


€ 


it 
=) 
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thread deadlock 


Deadlock, a deadly side of synchronization 


Synchronization saved Ryan and Monica from using their bank account at the 
same time, and has saved us from losing updates. But we also mentioned that we 


shouldn’t synchronize everything, one reason being that synchronization can slow 


your program down. 


There’s another important consideration: we need to be careful using 
synchronized code, because nothing will bring your program to its knees like 
thread deadlock. Thread deadlock happens when you have two threads, both 
of which are holding a key the other thread wants. There’s no way out of this 
scenario, so the two threads will simply sit and wait. And wait. And wait. 


If yow’re familiar with databases or other application servers, you might 
recognize the problem; databases often have a locking mechanism somewhat like 
synchronization. But a real transaction management system can sometimes deal 
with deadlock. It might assume, for example, that deadlock might have occurred 
when two transactions are taking too long to complete. But unlike Java, the 
application server can do a “transaction rollback” that returns the state of the 
rolled-back transaction to where it was before the transaction (the atomic part) 
began. 


Java has no mechanism to handle deadlock. It won’t even know deadlock occurred. 


So it’s up to you to design carefully. We’re not going to go into more detail about 
deadlock than you see on this page, so if you find yourself writing multithreaded 
code, you might want to study Java Concurrency in Practice by Brian Goetz, et al. It 


All it takes for 
deadlock are two 
objects and two 
threads. 


goes into a lot of detail about the sorts of problems you can face with concurrency 


(like deadlock), and approaches to address these problems. 


A simple deadlock scenario: 


@ 


3 synchronized method 
of object foo and gets 
the key. T 


Thread B enters a 
synchronized method 
of object bar and gets 


the key. 7 


Thread B tries to enter 
a synchronized method 
of object foo, but can’t 
get that key (because 

~ A has it). B goes to 
the waiting lounge, until 
the foo key is available. 
B keeps the bar key. 


Thread A enters a 


=) 


Thread A goes to 
fy sleep, holding the 
foo key. 


Wie 
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Thread A wakes up (still 
holding the foo key) 

and tries to enter a 
synchronized method on 
object bar but can’t get 
that key because B has 

it. A goes to the waiting 
lounge until the bar key is 
available (it never will be!). 


oD 


: Thread A can’t run until 
~ it can get the bar key, 
but B is holding the bar 
key and B can’t run until it 
gets the foo key that Ais 


holding and... 


race conditions and immutable data 


You don't always have to use synchronized 


Since synchronization can come with some costs (like performance and potential deadlocks), you 
should know about other ways to manage data that’s shared between threads. The java.util.concurrent 
package has lots of classes and utilities for working with multithreaded code. 


Atomic variables 


If the shared data is an int, long, or boolean, we might be able to replace it with an atomic 
variable. These classes provide methods that are atomic, i.e., can safely be used by a thread 
without worrying about another thread changing the object’s values at the same time. 


There are few types of atomic variable, e.g, AtomicInteger, AtomicLong, 
AtomicBoolean, and AtomicReference. 


We can fix our Lost Update problem with an AtomicInteger, instead of synchronizing the 
increment method. 


-a\ized 10 
class Balance { Ptomielnteger ee 
AtomicInteger balance = new AtomicInteger (0) ; Use om ead of an int Valve 
SaaS zero, 
public void increment() { intr 
a balance. incrementAndGet () ; BS Pp tndget atomiealh 7 
ITS used 5 adds 
} zed” K_& ze value by one ? y yi seh a 5 if te wie "ey even 
ehronize ingle 
No need to add * Te ie operations: need thot Sr cturns ih te vats neem - 
when You re usin, returned value. aia ple; ’ e i Value, b t we don’. +t 


So I canuse 
AtomicInteger as long 

as all I want to do is a simple 

increment. How does this help 

me if I want to do normal things 

like complex calculations? 


Atomic variables get more interesting when you use their compare-and-swap (GAS) 
operations. CAS is yet another way to make an atomic change to a value. You 
can use CAS on atomic variables by using the compareAndSet method. Yes, 
it’s a slightly different name! Gotta love programming, where naming is always 


the hardest problem to solve. 


The compareAndSet method takes a value, which is what you expect the atomic 
variable to be, compares it to the current value, and if that matches, then the 
operation will complete. 


In fact, we can use this to fix our Ryan and Monica problem, instead of locking 
the whole bank account with synchronized. 
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atomic variables 


Compare-and-swap with atomic variables 


How could we make use of atomic variables, and CAS (via compareAndSet), to solve Ryan and 
Monica’s problem? 


Since Ryan and Monica were both trying to access an int value, the account balance, we could use an 
AtomiclInteger to store that balance. We could then use compareAndSet to update the balance when 
someone wants to spend money. 


private AtomicInteger balance = new AtomicInteger (100) ; 


bay 
boolean success = balance.compareAndSet (expectedValue, newValue) KR 
tO 


dated to IF the Current balance ; 
True if the balance was Vint Same a ance is th 
eee value. [£ this is alse, the de : ‘a tted Value, : 


hanged and 
teh to do vert 


e 
) 
balance wasn € new value. 


decide what yo 


In plain English: 


“Set the balance to this new value only if the current balance is 
the same as this expected value, and tell me if the balance was 
actually changed.” 


Compare-and-swap uses optimistic locking. Optimistic locking means you don’t stop all 
threads from getting to the object; you ry to make the change, but you embrace the fact 
that the change might not happen. If it doesn’t succeed, you decide what to do. You 
might decide to try again, or to send a message letting the 
user know it didn’t work. 


This may be more work than simply locking all other When you're using CAS 
operations, you have to deal 


threads out from the object, but it can be faster than locking 
everything, For example, when the chances of multiple writes 


with the times when the 


of threads reading and not so many writing, then you may operation does NOT succeed. 


not want to pay the price of a lock on every write. 


happening at the same time are very low or if you have a lot 
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Ryan and Monica, going atomic 


race conditions and immutable data 


Let’s see the whole thing in action in Ryan and Monica’s bank account. We’ll put the balance in an AtomicInteger and 


use compareAndSet to make an atomic change to the balance. 


import java.util.concurrent.atomic.AtomicInteger; 


class BankAccount { 
private final AtomicInteger balance 


public int getBalance() { 
return balance.get(); 


} QL 


Use the 
Not a aed of 


value 


Q) 
se Ptomieinteger- 


public void spend(String name, int amount) { 


Like before, 


int initialBalance balance.get(); 
if (initialBalance >= amount) { 


Store the balance in an AtomieInteger, with 
he same initial value (7100) as al 


new AtomicInteger (100) ; 


method to get the int 


check if there’s enough money: This 


time, keep a record of the balance. 


boolean success = balance.compareAndSet (initialBalance, initialBalance - amount) ; 


Dale dif 
‘| NOT be change 
The erates nee does not mateh 


the initial , 

Lhe actual balance right now 
if ('success) { 

System.out.println("Sorry " + name + ", 


} 
} else f{ 


System.out.println("Sorry, not enough for " + 


you 


File Edit Window Help SorryMonica 


fe) 


%$ Java RyanAndMonicaTest 


Ryan is about to spend 
Monica is about to spend 
Ryan finishes spending 


Sorry Monica, you can’t buy this 


Monica finishes spending 


Monieg wa. 

shopping, oe 
Pay, the b . 

hey didn’t 


ss is the “spend” 
aa the gmount spent 
Lrom the 3ecount balance. 


haven't spent the money."); 


UC Ces. Ww. 
m CKy £. 
name) ; Tel) 0 ead Nora ‘ie 
did,’ Kd Monies va 


. Ir 
decide what fo they Can 
lo. 


java.util.concurrent has 
lots of useful classes and 
utilities for working with 
multithreaded code. Take 
a look at what's there! 
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immutable objects 


So if all these problems 
are caused by writing to a shared object, what 
if we stopped threads from changing the data in the 
shared objects? Is there a way to do that? 


Make an object immutable if you’re going to 
share it between threads and you don’t want the 
threads to change its data. 


The very best way to know for sure that another thread isn’t 
changing your data 1s to make it impossible to change the data in 
the object. When an object’s data cannot be changed, we call it an 
immutable object. 


Wand. 
ube 
ae —_—e.——___ might ade Ses ts 
public final class ImmutableData { Values sm t 
Pa private final String name; ™mutapy, make 1, ° 


e th. 
private final int value; le Clase wis 
thal. 
public ImmutableData(String name, int value) { 


this.name = name; . . 
= \\ fields chovld be this.value = value; ri Kd ice? 
FINAL The 2 } \oe ay 
will be eet ont on er eul i 


ion 0 
dhe Sield oe public String getName() { return name; } he ad 
(Ave) 


t 

raerae be chand¢e public int getValue() { return value; } 
gxterware } | 

Z waite objee 

sh ers. h may ha 

ould hot be ne Alues insid i tters, b Z 
ed € Object 
ethog 


There are times when adding the final keyword isn’t 
enough to prevent changes. When do you think that 
might be the case? We'll give you a clue... 
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race conditions and immutable data 


Using immutable objects 


It is terribly convenient to be able to change data on a shared object and as- 
sume that all the other threads will be able to see these changes. 


However, we’ve also seen that while it’s convenient, it’s not very safe. 


On the other hand, when a thread 1s working with an object that cannot be 
changed, it can make assumptions about the data in that object; e.g., once the 
thread has read a value from the object, it knows that data can’t change. 


We don’t need to use synchronization or other mechanisms to control who 
changes the data because it can’t change. 


Well, duh. If the data can't be 
changed, then of course I know no one 
else has altered it. But what's the use of 
an object that can't be changed? What if 
T need to update its values? 


Working with immutable objects means thinking 
in a different way. 


Instead of making changes to the same object, we replace the old 
object with a new one. The new object has the updated values, and 
any threads that need the new values need to use the new object. 


What happens to the old object? Well, if it’s still beg used by 
something (and it might be—1t’s perfectly valid sometimes to work 
with older data), it will hang around on the heap. If it’s not being 
used, it’ll be garbage collected, and we don’t have to worry about it 
anymore. 
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changing immutable objects 


Changing immutable data 


Imagine a system that has customers, and that each Customer 
object has an Address that represents the street address of a 
customer. If the customer’s Address is an immutable object (all 
its fields are final and the data cannot be changed), how do you 
change the customer’s address when they move? 


& The Customer has a reference to the original Address 
object containing the customer's street address data. 


(2) When the customer moves, a brand new Address 
object is created with the new street address for the 


customer. 
42 Electric 


3 ) The Customer object's reference to their address is 
changed to point to the new Address object. 


there are no 


Dumb Questions 


Q: What happens if other parts of the program have a 
reference to the old Address? 


A: Actually sometimes we want this. Imagine the 
customer placed an order to be delivered to their original 
address. We still want the details of that order to have the 
original address; we don’t want it changed to contain the 
details of the new address. 


Once the customer changes their address (and the Customer 
contains a reference to the new address object), then we want 
new orders to use the new Address object. 
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Wait just a minute! The Address 
object is immutable and doesn't 
change, but the Customer object 
still has to change. 


Absolutely right. If your system has data that changes, those 
changes do have to happen somewhere. The key idea to take away 
from this discussion is that not all of the classes in your application 
have to have data that changes. In fact, we’d argue for minimizing 
the places where things change. Then, there are far fewer places 
where you have to think about what happens if multiple threads 
are making changes at the same time. 


There are a number of techniques for working effectively with 
immutable data classes; we’ve just scratched the surface here. It 
is interesting to note that Java 16 introduced records, which are 
immutable data classes provided directly by the language. 


Use immutable data classes where you can. 


Limit the number of places where data can be 
changed hy multiple threads. 
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shared data 


Are we there yet? This 
concurrency stuff has 
been going on forever. 


More problems with shared data 


We're nearly there, we promise! Just one last thing to look at. 


So far we’ve seen all sorts of problems that can come from 
many threads writing to the same data. This applies to data in 
Collections too. 


We can even have problems when we have lots of threads reading 
the same data, even if only one thread is making changes to it. 


This code has just one thread writing to a collection, but two 
threads reading it. 


public class ConcurrentReaders { 
public static void main(String[] args) { 
List<Chat> chatHistory = new ArrayList<>() ; 
ExecutorService executor = Executors.newFixedThreadPool (3) ; 
for (int i = 0; i < 5; itt) { which is NOT fterayL ist 
executor.execute(() -> chatHistory.add(new Chat("Hi there!"))) safe 2 


executor.execute(() -> System.out.println(chatHistory) ) ; Cucahe dawnt Ling thread 
i 


executor.execute(() -> System.out.println(chatHistory) ) ; that adds to the List, and 
} two threads that read 
executor. shutdown () ; Lrom the list. Loop a tew 
} times to try to provoke 
} the problem. 
final class Chat { 
private final String message; Making an Ob: 
private final LocalDateTime timestamp; the data ins; viata “Final” doesn’t ‘aa 
at the re eren . ject won't ¢h i rantee 
6. an 7 
public Chat(String message) { LotalDateTime ars ae £ change Stina ae 
this.message = message; mutable, so this is safe. 
timestamp = LocalDateTime.now() ; abl 
Fy e. 
! |nstances of Chat ave wu 


public String toString() { 
String time = timestamp. format (ofLocalizedTime (MEDIUM) ) ; 
return time + " " + message; 
} 
} 
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Reading from a changing data 
structure causes an Exception 


Running the code on the last page causes an Exception to be thrown, 
sometimes. By now you know these sorts of issues depend a lot on 
the whims of the hardware, the operating system, and the JVM. 


File Edit Window Help PoorBrunonono 


% java ConcurrentReaders 


[] 
[] 
[18:43:59 Hi there!, 18:43:59 Hi there! ] 
[18:43:59 Hi there!, 18:43:59 Hi there! ] 
[18:43:59 Hi there!, 18:43:59 Hi there!, 18:43:59 Hi there!] 
[18:43:59 i there!, 18:43:59 i there!, 18:43:59 Hi there! ] 
Exception in thread "pool-1-thread-2" Exception in thread "pool-1-thread-1" java.util. 
ConcurrentModificationException 
at java.base/java.util.ArrayList$Itr.checkForComodification (ArrayList. java:1043) 


at java.base/java.util.ArrayList$Itr.next (ArrayList. java: 997) 


at java.base/java.util.AbstractCollection. toString (AbstractCollection.java:472) 


at java.base/java.lang.String.valueOf (String. java:2951) 
at java.base/java.io.PrintStream.println(PrintStream. java: 897) 


ConcurrentReaders.lambda$main$2 (ConcurrentReaders.java:17) 


. «on is thrown bY 


ce rea WHILE this thread 1s reading 


If a collection is changed by one thread while 
another thread is reading that collection, you 
can get a ConcurrentModificationException. 
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Use a thread-safe data structure 


Clearly good ol’ ArrayList just isn’t going to cut it if you have threads reading data that’s 
being changed at the same time. Luckily for us, there are other options. We want a 
thread-safe data structure, one that can be written to, and read from, by multiple threads 
at the same time. 


The java.util.concurrent package has a number of thread-safe data structures, and we’re 
going to look at CopyOnWriteArraylList to solve this specific problem. 


CopyOnWriteArray List is a reasonable choice when you have a List that is being read a Ane 
lot, but not changed very often. We'll see why later. 


so 
erate wk Cor avy 
public class ConcurrentReaders { cepacern® 
args) { 


public static void main(String[] 
List<Chat> chatHistory = new CopyOnWriteArrayList<>() ; 
ExecutorServic xecutor = Executors.newFixedThreadPool (3) ; 
for (int i = 0; i < 5; itt) { 
xecutor.execute(() -> chatHistory.add(new Chat ("Hi there!"))); 
xecutor.execute(() -> System.out.println(chatHistory) ); 
xecutor.execute(() -> System.out.println(chatHistory) ); 


} 
executor.shutdown () ; The rest of 


} Sdme as before. Code is exactly the 


File Edit Window Help AyMariposa 


java ConcurrentReaders 


Hi there!, 10:26: Hi there! ] 
Hi there!, 10:26: Hi there!, 10:26:22 10:26:22 Hi there! ] 
Hi there!, 10:26: Hi there!, 10:26:22 
Hi there!, 10:26: Hi there!, 10:26:22 10:26:22 Hi there! ] 
BAB Hi there!, 10:26: Hi there!, 10:26:22 : there!, 10:26:22 Hi there! 
[10:26: Hi there!, 10:26: Hi there!, 10:26:22 10:26:22 Hi there!, 10:26:22 Hi there! 


Process finished with exit code 0 


No Exception! 


664 chapter 18 


race conditions and immutable data 


CopyOnWriteArrayList 


CopyOnWriteArray List uses immutability to provide safe access for reading threads while other threads are writing. 


How does it work? Well, it does what it says on the tin: when a thread is writing to the list, it’s actually writing to a copy of 
the list. When the changes have been made, then the new copy replaces the original. In the meantime, any threads that 


were reading the list before the change are happily (and safely!) reading the original. 


2 ) 


An instance of CopyOnWriteArrayList contains an 
ordered set of data, like an array. 935 | 34 

CopyOnWriteArrayList 
When Thread A reads the CopyOnWriteArrayList, a) 
it gets an Iterator that allows it to read a snapshot —> iteratine e 

the list data at that point in time. 
of the list data at that point in time ie ee 24 | 13) 
for reading 
pyOnWriteArrayLick 


Thread B writes data to the CopyOnWrite- 
ArrayList by adding a new element, and the 
CopyOnWriteArray creates a copy of the 
list data before any changes are made. This 
is invisible to any of the reading or writing 


A 
threads. " copy for 
Writing 35 | 34 a 
yy” 
A 


—? iterating a 
Tefevence > | 935 | 34 


or reading 


noe 
When Thread B makes changes to “the list,” A 
it's actually making changes to this copy. It's —> iterating ye 
happy knowing the changes are being made. 35 |3e 
The reading threads like Thread A are not veference > ee) ea |e 
affected at all; they're iterating over the for reading 
snapshot of the original data. wit to] S| a \rx\ s\ ¢ 

copy cal 
Copyo® 

Once Thread B has finished its updates, then the iterating ‘an 
original data is replaced with the new data. 3 
If Thread A is still reading, it's safely reading the alee 


old data. If any other threads start reading after 


the change, they get the new data. a | > \3\ 5 | e 
reference |x cl ie i uf 


: ws 
or reading a 


< 


Copyo’ 
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concurrency issues 


there; are_no 


Dumb Questions 


- Doesn't using 
CopyOnWriteArrayList mean that 
some reading threads will be reading 
old data? 


A: Yes, the reading threads will 
always be working off data that is 

a snapshot of the data from when 
they first started reading. This means 
that potentially the data might 

be out of date at some point, but 

at least it’s not going to throwa 
ConcurrentModificationException. 


Q: Isn't it bad to be using out of 
date data? 


A: Not necessarily. In many 
systems this is “good enough.’ Think, 
for example, about a website that 
shows live news. Yes, you want it to 
be pretty up to date, but it doesn't 
have to be up to date to the latest 
millisecond; it’s probably fine if some 
news is a few seconds old. 


* But I don’t want my bank 
statement to be even slightly out 
of date! How can I make sure that 
critical shared data is always correct? 


A: CopyOnWriteArrayList is 
probably not the right choice if all 
threads need to be working off exactly 
the same data. Other data structures, 
like Vector, provide thread-safety by 
using locks to ensure only one thread 
at a time has access to the data. 

This is safe, but can be slow—you're 
not getting any benefits of multi- 
threading if your threads need to wait 
their turn to get to their data. 
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Q: So CopyOnWriteArrayList is a fast 
thread-safe data structure? 


A: Well.. it depends! It’s fast (compared 
to a locking Collection) if you have lots of 
reading threads and not many writes. But 
if there’s a lot of writing going on, it might 
not be the best data structure. The cost of 
creating a new copy of the data every time 
a single write is made might be too high 
for some applications. 


Q: Why isn’t there an easy answer 
to the best way to do this concurrency 
stuff? 


A: Concurrent programming is 

all about trade-offs. You need a good 
understanding of what your application is 
doing, how it should work, and the hardware 
and environment that’s running it. 


If you find yourself wondering which 
approach is better for your application, 
it’s probably a good time to learn about 
performance testing so you can measure 
exactly how each approach impacts the 
performance in your system. 


Q: You never told us about the case 
where adding final to a field declaration 
is not enough to make sure that value is 
never changed. What's the deal? 


A: Good catch! The “deal” is that if your 
field is a reference to another object, like 

a Collection or one of your own objects, 
using final does not prevent another 
thread from changing the values inside 
that object. The only way to make sure 
that doesn’t happen is to make sure all 
your fields that are references refer only to 
immutable objects themselves. Otherwise, 
your immutable object can have data that 
changes. 


See the LocalDateTime case on page 662. 


Thread-safe 
collections in early 
versions of Java 
were made safe via 
locking. For example, 
java.util. Vector. 


Java 5 introduced 
concurrent data 
structures in 
java.util.concurrent. 
These do NOT use 
locking. 


race conditions and immutable data 


BULLET POINTS 


You can have serious problems with threads if two or more threads are trying to 
change the same data. 


Two or more threads accessing the same object can lead to data corruption 
if one thread, for example, leaves the running state while still in the middle of 
manipulating an object's critical state. 


To make your objects thread-safe, decide which statements should be treated as 
one atomic process. In other words, decide which methods must run to completion 
before another thread enters the same method on the same object. 


Use the keyword synchronized to modify a method declaration when you 
want to prevent two threads from entering that method. 


Every object has a single lock, with a single key for that lock. Most of the time 
we don’t care about that lock; locks come into play only when an object has 
synchronized methods or use the synchronized keyword with a specified object. 


When a thread attempts to enter a synchronized method, the thread must get the 
key for the object (the object whose method the thread is trying to run). If the key 
is not available (because another thread already has it), the thread goes into a 
kind of waiting lounge until the key becomes available. 


Even if an object has more than one synchronized method, there is still only one 
key. Once any thread has entered a synchronized method on that object, no 
thread can enter any other synchronized method on the same object. This restric- 
tion lets you protect your data by synchronizing any method that manipulates the 
data. 


The synchronized keyword isn’t the only way to safeguard your data from multi- 
threaded changes. Atomic variables, with CAS operations, may be suitable if it’s 
just one value that is being changed by multiple threads. 


It’s writing data from multiple threads that causes the most problems, not reading, 
so consider if your data needs to be changed at all or if it can be immutable. 


Make a class immutable by making the class final, making all the fields final, 
setting the values just once in the constructor or field declaration, and having no 
setters or other methods that can change the data. 


Having immutable objects in your application doesn’t mean nothing ever changes; 
it means that you limit the parts of your application where you have to worry about 
multiple threads changing the data. 


There are thread-safe data structures that let you have multiple threads reading 
the data while one (or more) threads change the data. Some of these are in 
java.util.concurrent. 


Concurrent programming is difficult! But there are plenty of tools to help you. 


you are here > 
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exercise: BE the JVM 


Face BE the JVM 


The Java file on this page represents a 

. complete source file. Your job is to play 
JVM and determine what the output would 
, be when the program runs. 


How might you fix it, making 
sure the output is correct 
every time? 


———— Answers on page 670. 


import java.util.*; 
import java.util.concurrent.*; 


public class TwoThreadsWriting { 

public static void main(String[] args) { 
ExecutorService threadPool = Executors.newFixedThreadPool (2) ; 
Data data = new Data(); 
threadPool.execute(() -> addLetterToData('a', data)); 
threadPool.execute(() -> addLetterToData('A', data)); 
threadPool . shutdown () ; 

} 


private static void addLetterToData(char letter, Data data) { 

for (int i = 0; i < 26; itt) { 

data.addLetter (letter++) ; 

try { 

Thread.sleep (50) ; 

} catch (InterruptedException ignored) {} 
} 
System.out.println (Thread. currentThread().getName() + data.getLetters () ) ; 
System.out.println (Thread. currentThread () .getName () 

+ " size = " + data.getLetters().size()); 


} 


final class Data { 
private final List<String> letters = new ArrayList<>(); 


public List<String> getLetters() {return letters; } 
public void addLetter(char letter) { 


letters .add(String.valueOf (letter) ) ; 
} 
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O-® Near-miss at the airlock 


CA As Sarah joined the onboard development team’s design review meeting, she gazed out the 
portal at sunrise over the Indian Ocean. Even though the ship’s conference room was incredibly 
claustrophobic, the sight of the growing blue and white crescent overtaking night on the planet 
below filled Sarah with awe and appreciation. 


Oo. 9. 
Five-Minute This morning’s meeting was focused on the control systems for the orbiter’s airlocks. As 
Mystery the final construction phases were nearing their end, the number of spacewalks was scheduled 
to increase dramatically, and traffic was high both in and out of the ship’s airlocks. “Good 
morning, Sarah,” said Tom, “Your timing is perfect; we’re just starting the detailed 
design review.” 


“As you all know,” said Tom, “Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out. Whenever spacewalkers are entering or exiting the orbiter they 
will use these terminals to initiate the airlock sequences.” Sarah nodded and asked, “Tom, can you 
tell us what the method sequences are for entry and exit?” Tom rose and floated to the whiteboard, 
“First, here’s the exit sequence method’s pseudocode.” Tom quickly wrote on the board. 


orbiterAirlockExitSequence () 


verifyPortalStatus(); 
pressurizeAirlock(); 
openInnerHatch (); 
confirmAirlockOccupied (); 
closeInnerHatch (); 
decompressAirlock(); 
openOuterHatch () ; 
confirmAirlockVacated(); 


closeOuterHatch (); 


“To ensure that the sequence is not interrupted, we have synchronized all of the methods 
called by the orbiterAirlockExitSequence() method,” Tom explained. “We'd hate to see a 
returning spacewalker inadvertently catch a buddy with his space pants down!” 


Everyone chuckled as Tom erased the whiteboard, but something didn’t feel right to Sarah, 
and it finally clicked as Tom began to write the entry sequence pseudocode on the whiteboard. 
“Wait a minute, Tom!” cried Sarah, “I think we’ve got a big flaw in the exit sequence design. 
Let’s go back and revisit it; it could be critical!” 


Why did Sarah stop the meeting? What did she suspect? 


——————__ Answers on page 671. 
P § youarehere> 669 


exercise solutions 


BE the JVM (from page 668) 


The answer is the output won’t be the same every time. In theory, one 
might expect the size to always be 52 (2 X 26 letters in the alphabet), but in 
fact this is one of those lost-update problems. 


Exercise Solutions 


File Edit Window Help ZeCount 
% java TwoThreadsWriting 
pool-1-thread-2[a, A, b, B, c, C H, i, j, K, k, 


pool-1-thread-l[a, A, b, B, c, C Hy iy Jy By Ky 
pool-1-thread-1 size = 40 
pool-1-thread-2 size = 40 


le output. Your output probably won't look 
ae ee as this, but if you predicted that 
the size would be less than 92, you win a Cookie. 


It can be solved in two different ways; both are valid. 


Synchronize the write method 


public synchronized void addLetter(char letter) { 
letters .add(String.valueOf (letter) ) ; 


If this method is synchronized, only one thread at a time 


ill be lost. 
ite to the data, and therefore no updates will be | 
This will not work if there's a DIFFERENT thread reading 


at the same time as one of these threads are writing, 


Use a thread-safe collection 
private final List<String> letters = new CopyOnWriteArrayList<>() ; 


Using C , ; 
M) opyOnWriteArra List wil 
ene safely write to Le fivililas anced 


Use either solution, you do NOT have to do hoth!! 


With a thread-safe collection, you don’t have to 
synchronize the writing method. 
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Five-Minute Mystery 


(from page 669) 


What did Sarah know? 


Sarah realized that in order to ensure that the entire 
exit sequence would run without interruption the 
orbiterAirlockExitSequence() method needed to 
be synchronized. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn’t be interrupted in the 
middle of any of the lower-level method calls, but it could 
be interrupted in between those calls. Sarah knew that the 
entire sequence should be run as one atomic unit, and if 
the orbiterAirlockExitSequence() method was 
synchronized, it could not be interrupted at any point. 
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J x 
Appendix A: 


Final Code Kitchen * ant, to the 
Your message oe ° with your 
“s, 2 ond) 
herr laye hen YOu 
ot} me beat patter w Y 
ture ) 
nit “send 
ee@ Cyber BeatBox 
Bass Drum Start 
Closed Hi-Hat : » « Stop 
Open Hi-Hat [ _ 
Se a ee = Tempo Up 
Acoustic Snare : oaeencnnees oR 
Crash Cymbal _ Tempo Down — 
Hand Clap Saeasepeaeaseaeuseuseseeaseveeanss~es e sendit 
High Tom Try this| 
Hi Bongo 
Maracas 2 
pee 
ERS a ; z = z = : Z ~ |RiverO: Dance beat 
Low Conga EstuaryEchoO: Groove #2 revised 
Cowbell River1: Energy build up 
Vibraslap 


Low-mid Tom 
High Agogo 


Open Hi Conga _ 


k ' playe J s essages From 
Finally, the complete version of the BeatBox! iS ae one to load 
Pa 
I imple MusicS h with i aq rat gees 
t connects to a simple lusicServer so that you can hyp and then eliek 
send and receive heat patterns with other clients. © b Play it 
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final BeatBox code 


Final BeatBox client program 


Most of this code is the same as the code from the Code Kitchens in the previous chapters, so we don’t 
annotate the whole thing again. The new parts include: 


GUI: Two new components are added for the text area that displays incoming messages (actually a 
scrolling list) and the text field. 


NETWORKING: Just like the SimpleChatClient in this chapter, the BeatBox now connects to the 
server and gets an input and output stream. 


MULTITHREADED: Again, just like the SimpleChatClient, we start a “reader” job that keeps looking 
for incoming messages from the server. But instead of just text, the messages coming in include TWO 
objects: the String message and the serialized array (the thing that holds the state of all the checkboxes). 


All the code 1s available at https://oreil. ly /hffava_3e_examples. 


import javax.sound.midi.*; 
import javax.swing.*; 

import javax.swing.event.*; 
import java.awt.*; 

import java.io.*; 

import java.net.Socket; 

import java.util.*; 

import java.util.concurrent.*; 


import static javax.sound.midi.ShortMessage. *; 
public class BeatBoxFinal { 

private JList<String> incomingList; 

private JTextArea userMessage; 


private ArrayList<JCheckBox> checkboxList; 


private Vector<String> listVector = new Vector<>() ; 
private HashMap<String, boolean[]> otherSeqsMap = new HashMap<>() ; 


private String userName; 
private int nextNum; 


private ObjectOutputStream out; 


riv. j In r in; 

alle ican khe names ok the These vepresent the 

private Sequencer sequencer; These ave ks, a8 3 Ser cul actual drum an The 

private Sequence sequence; instr ‘\din, tne drum channel is like 

private Track track; avd) 7 eath ow): Pr Plano, except each 

\abels (on ey on the Piano is a 

String[] instrumentNames = {"Bass Drum", "Closed Hi-Hat", different drum. So the 
"Open Hi-Hat", "Acoustic Snare", "Crash Cymbal", "Hand Clap", number ‘35’ is the key 
"High Tom", "Hi Bongo", "Maracas", "Whistle", "Low Conga", or the Bass drum, 42. 
"Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", is Closed Hi-Hat, ete. 


"Open Hi Conga"}; 
int[] instruments = {35, 42, 46, 38, 49, 39, 50, 60, 70, 72, 64, 56, 58, 47, 67, 63}; 
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public static void main(String[] args) { 


} 


appendix A Final Code Kitchen 
ame- 
new BeatBoxFinal () .startUp(args[0]); Add a tommand-line argument for Your screen nv 


Example: ‘7% java BeatBoxFinal theFlash 


public void startUp(String name) { 


} 


userName = name; : 0, and make 

// open connection to the server Set wp se praneys he We've 

try { (and start) Aes areca oF Chaenels 
Socket socket = new Socket("127.0.0.1", 4242); using, Sotke ee better with Object 
out = new ObjectOutputStream (socket.getOutputStream() ) ; because ia ee 
in = new ObjectInputStream(socket.getInputStream () ) ; Input/Outpe een 
ExecutorService executor = Executors.newSingleThreadExecutor () ; 
executor.submit (new RemoteReader () ) ; 

} catch (Exception ex) { 
System.out.println("Couldn’t connect-you’11l have to play alone."); 

} 

setUpMidi () ; 

buildGUI () ; 


You've seen this GU| code 


public void buildGUI() { before Chapter |5. 
) 


JFrame frame = new JFrame("Cyber BeatBox") ; 

frame .setDefaultCloseOperation (JFrame .EXIT_ON CLOSE) ; 

BorderLayout layout = new BorderLayout() ; 

JPanel background = new JPanel (layout) ; 

background. setBorder (BorderFactory.createEmptyBorder(10, 10, 10, 10)); 


M 
» 
Box buttonBox new Box (BoxLayout.Y_ AXIS) ; Pie An empty border 
JButton start = new JButton("Start") ; where th 
start.addActionListener(e -> buildTrackAndStart() ) ; 
buttonBox.add(start) ; 


JButton stop = new JButton ("Stop") ; ; i aifie method 
stop.addActionListener(e -> sequencer.stop()); Lambda expressions ec ere ss iprened. 
buttonBox.add (stop) ; on this class when the button 's P 


JButton upTempo = new JButton("Tempo Up") ; 
upTempo.addActionListener(e -> changeTempo(1.03f) ); lve 
buttonBox.add(upTempo) ; KK... Th default tempo 1s eon we 
e : L 4 Io per eck. 
JButton downTempo = new JButton("Tempo Down") ; a adjusting t 
downTempo.addActionListener(e -> changeTempo(0.97£) ) ; 
buttonBox.add(downTempo) ; — 


JButton sendIt = new JButton("sendIt") ; This is new send the panea ii 
sendIt.addActionListener(e -> sendMessageAndTracks()); the current beat sequence 
buttonBox.add(sendIt) ; musié server: 

userMessage = new JTextArea() ; h 
userMessage.setLineWrap (true) ; Create a text area for the 
userMessage.setWrapStyleWord (true) ; user to type their message: 


JScrollPane messageScroller = new JScrollPane (userMessage) ; 
buttonBox.add(messageScroller) ; 
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. ; This is where the incomin 
We saw JList briefly in Chapter I5 v : aus ae 


jou \u 
Ce Crom the list to load an 

incomingList = new JList<>(); 
incomingList.addListSelectionListener (new MyListSelectionListener () ) ; 
incomingList.setSelectionMode (ListSelectionModel .SINGLE SELECTION) ; 
JScrollPane theList = new JScrollPane (incomingList) ; 
buttonBox.add(theList) ; 
incomingList.setListData (listVector) ; 


Box nameBox = new Box (BoxLayout.Y_AXIS) ; This border on each instrument, 

for (String instrumentName : instrumentNames) { helps them line up with the ch ‘bbe 
JLabel instrumentLabel = new JLabel (instrumentName) ; erases: 
instrumentLabel .setBorder (BorderFactory.createEmptyBorder(4, 1, 4, 1)); 
nameBox.add(instrumentLabel) ; 


} 


background. add(BorderLayout.EAST, buttonBox) ; 
background.add(BorderLayout.WEST, nameBox) ; 


. e \ets you 
frame.getContentPane () -add (background) F This layout manager on meee gw Lh 
GridLayout grid = new GridLayout(16, 16) ; fae components in a 9 
grid.setVgap (1) ; pt “A columns: 
grid.setHgap (2) ; rows an 
JPanel mainPanel = new JPanel (grid) ; 
background.add(BorderLayout.CENTER, mainPanel) ; 
checkboxList = new ArrayList<>() ; 
for (int i = 0; i < 256; i++) { 

JCheckBox c = new JCheckBox () ; Mak 
c.setSelected (false) ; “Pol € the cheek boxes, set them ts 
checkboxList.add(c) ; - (so they aren't checked) and 
mainPanel .add(c) ; add them to he ArrayList Po 
st AN, 
} the 6U| Panel. AND to 
frame.setBounds (50, 50, 300, 300); 
frame. pack () ; 
frame.setVisible (true) ; 
} 
private void setUpMidi() { 
try { 
sequencer = MidiSystem.getSequencer () ; 
sequencer. open () ; Sequencer make 2 
_ s : s PP 4): et the >€% ake a Track. 
sequence = new Sequence (Sequence.PPQ, 4); Sequences and 


track = sequence.createTrack () ; 
sequencer .setTempoInBPM (120) ; 

} catch (Exception e) { 
e.printStackTrace () ; 
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st LOOK at ane vad and play the attached beat pattern 


appendix A Final Code Kitchen 


private void buildTrackAndStart() { 


sequence.deleteTrack (track) ; wn hough the 

track = sequence.createTrack () ; Build a fyatk by na state and marys 

for (int i = 0; i < 16; itt) { pheckboxes % fs “ent Cand making ONE 
trackList = new ArrayList<>() ; bat to an in aes This is PE are 
int key = instruments [i]; Midievent. Lor TLY 3s vt was 0 th a" 
for (int j = 0; j < 16; j++) { but it is EXAC the Code Kitehen 


é ain: 
JCheckBox jc = checkboxList.get(j + (16 * i)); chapters» so rerer full explanation ay 


if (jc.isSelected()) { 
trackList.add (key) ; 
} else { 


trackList.add(null); // because this slot should be empty in the track 


Chapter 


} 
} 
makeTracks (trackList) ; 


track.add(makeEvent (CONTROL CHANGE, 1, 127, 0, 16)); 
} 


track .add(makeEvent (PROGRAM CHANGE, 9, 1, 0, 15)); // - so we always go to 16 beats 


try { 
sequencer .setSequence (sequence) ; 
sequencer .setLoopCount (sequencer .LOOP_CONTINUOUSLY) ; 
sequencer .setTempoInBPM (120) ; 
sequencer.start() ; 
} catch (Exception e) { 
e.printStackTrace() ; 


} 


private void changeTempo (float tempoMultiplier) { The Tempo Factor stales - 
float tempoFactor = sequencer.getTempoFactor () ; sequencer's tempo by the tattor 


sequencer.setTempoFactor(tempoFactor * tempoMultiplier) ; provided, slowing the beat down or 


} speeding it up. 


private void sendMessageAndTracks() { 
boolean[] checkboxState = new boolean[256] ; 
for (int i = 0; i < 256; i++) { 
JCheckBox check = checkboxList.get (i) ; 
if (check.isSelected()) { 


; -« is new.nit’s a lot like the SimpleChatClient, except instead 
ier Aa Limahiey aie a we ee two objects (the 
Strin message and the beat pattern) and write those two 
7 { objects to the socket output stream (to the server). 

out.writeObject (userName + nextNum++ + ": " + userMessage.getText() ) ; 


out .writeObject (checkboxState) ; 
} catch (IOException e) { 


System.out.println("Terribly sorry. Could not send it to the server."); 
e.printStackTrace() ; 


} 


userMessage.setText("") ; 
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public class MyListSelectionListener implements ListSelectionListener { 
public void valueChanged (ListSelectionEvent lse) { This is als 
if (!lse.getValueIsAdjusting()) { ; ° new—9 


i : 
String selected = incomingList.getSelectedValue() ; fe when fon istener that 4 F 
if (selected != null) { on the high Wee made 9 yi 

// now go to the map, and change the sequence Casey ns messages, Whe ton 
boolean[] selectedState = otherSeqsMap.get (selected) ; IM Diy ce essage, i“ 
changeSequence (selectedState) ; b eat. Sa ieee 
Sequencer: stop () ; Called . ee it’s j : ane 
buildTrackAndStart () ; Playing ip Then @?? and start : 
eCau é S Some if 
J getting a iittle quirky We ests 
} IstGele, tionEvey, a 95 about. 


} 


private void changeSequence (boolean[] checkboxState) { 
for (int i = 0; i < 256; itt) { This method ; 
JCheckBox check = checkboxList.get(i) ; something Cros, oe the user selects 
check. setSelected (checkboxState[i]) ; change the pattern 1 ng IMMEDIATELY 
} he one they selected. 


} 


public void makeTracks (ArrayList<Integer> list) { 
for (int i= 0; i < list.size(); i++) { 
Integer instrumentKey = list.get(i) ; 
if (instrumentKey != null) { 
track.add(makeEvent (NOTE _ON, 9, instrumentKey, 100, i)); 
track.add(makeEvent (NOTE OFF, 9, instrumentKey, 100, i+ 1)); 
} : 
All Ehe MIDI stuff is exactly the same as 


| was in the previous versions: 


public static MidiEvent makeEvent(int cmd, int chnl, int one, int two, int tick) { 
MidiEvent event = null; 
try { 
ShortMessage msg = new ShortMessage() ; 
msg.setMessage (cmd, chnl, one, two) ; 
event = new MidiEvent(msg, tick) ; 
} catch (Exception e) { 
e.printStackTrace () ; 


} 


return event; 
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public class RemoteReader implements Runnable { 
public void run() { 
try { 


} 


} 


} 
} 


Object obj; 

while ((obj = in.readObject()) != null) { 
System.out.printlin ("got an object from server") ; 
System.out.printin (obj.getClass()) ; 


String nameToShow = (String) obj; 
boolean[] checkboxState = 
otherSeqsMap.put(nameToShow, checkboxState) ; 


listVector .add(nameToShow) ; 
incomingList.setListData (listVector) 


} 


e.printStackTrace () ; 


Multi-cateh: if you want to eatth two 
different Exceptions but do the same 
thing with them (like here, we just want 
to print them out), you can separate the 
two Exception classes with a Pipe. 


ond messg 
(boolean[]) in.readObject () ; (deserialize) ie Comes in, we y 
message and 11° two objert. ead 
cheekbe, nd the g J, (Lhe 


is ComPonent. 
Addi sc 4 
catch (IOException | eee a ig en Isa 
a-Si  e E in ie 
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- it veads 
. Lnvead job yin 


the server 


values) 7 


We want to ade values), 


d to th 


ou keep 


a Vettor of the lists data 


€Ctor is an old—L3shi 
Arra List), and [. tell ‘ 


the JList to us 
Vector as it’ aera 


what to display in the list. 
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erp your pencil —+ Yours to solve. 
IN 


What are some of the ways you can improve this program? 
Here are a few ideas to get you started: 


1. Once you select a pattern, whatever current pattern was playing is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you're out of luck. You might want to pop up a dialog box that 
asks the user if he’d like to save the current pattern. 


2. If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
you've passed in a command-line argument. If the user doesn’t supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 


3. It might be nice to have a feature where you can click a button and it will 
generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing “foundation” 
patterns, like one for jazz, rock, reggae, etc., that the user can add to. 


You don't have to type all the code in! You can clone it from the repository at 
All the code is available at https://oreil.ly/hflava_3e_examples. 


There's also an alternative BeatBox solution, which uses Maps and Lists in- 
stead of the arrays used in this solution. There’s more than one way to solve 
any problem! 
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Final BeatBox server program 


Most of this code is identical to the SimpleChatServer we made in Chapter 17, 
Make a Connection. The only difference, in fact, is that this server receives, and 
then re-sends, two serialized objects instead of a plain String (although one of 


the serialized objects happens to be a String). 


import java 


import java. 
sutil.*; 


import java 


import java. 


.10.%*; 


net.*; 


util.concurrent.*; 


public class MusicServer { 
final List<ObjectOutputStream> clientOutputStreams = new ArrayList<>() ; 


cent, output 
a ofall the client owt 


public static void main(String[] args) { List essages 
new MusicServer() .go() ; cbireams to send = enewed- 
} when 2 message ' ’ 


public void go() { 


try { 


ServerSocket serverSock = new ServerSocket (4242) ; 


ExecutorService threadPool = Executors .newCachedThreadPool () ; 


while (!serverSock.isClosed()) { 
Socket clientSocket = serverSock.accept() ; 
ObjectOutputStream out = new ObjectOutputStream(clientSocket.getOutputStream () ) ; 


clientOutputStreams.add (out) ; Keep listening for tlie 4 
n 


Connections; create g 


ClientHandler clientHandler = new ClientHandler(clientSocket) ; new Sorke+ and ne 
threadPool .execute (clientHandler) ; ClientHandler- Bie Ne h 
System.out.println("Got a connection") ; Connected elient = 


} 


} catch (IOException e) { 
e.printStackTrace () ; 


} 
} 


public void tellEveryone (Object one, Object two) { 
for (ObjectOutputStream clientOutputStream : clientOutputStreams) { 


try { 
clientOutputStream.writeObject (one) ; Gindl the message and the 
clientOutputStream.writeObject (two) ; beat pattern to all the 


} catch (IOException e) { 


clients. 


e.printStackTrace () ; 


} 
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public class ClientHandler implements Runnable { 
private ObjectInputStream in; 


lic Cli 1 k Kk Create an ObjectlnputStrean a 
pres ientHandler (Socket socket) { reading messages trom this client. 
in = new ObjectInputStream(socket.getInputStream () ) ; 
} catch (IOException e) { 
e.printStackTrace () ; 
} 
} 


public void run() { 
Object userName ; 
Object beatSequence; 


aif): 
: SA9e, it’s made 
When the client sends a mes 
=a Mees Sg kent 
while ((userName = in.readObject()) != null) { (eae and their messages and a Objec 
Pesce reaee eee ae ae brat represents the beat sequence (this 
is actually a boolean array, but the server 
System.out.println ("read two objects") ; d L eave about that). 
tellEveryone (userName, beatSequence) ; oe 
} 
} catch (IOException | sessional aS 
e.printStackTrace () ; Once we've v! 
} e seque 5 the message and 
: ne, send th n 
} e tlients Gin hie ese to all 
} 'ng this one) 
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Appendix B: 


The top ten-ish topics that didn't make 
it into the rest of the book... 


You mean, there's still 
MORE? Doesn't this 
book EVER end? 


We covered a lot of ground, and you're almost finished with this book. We'll miss you, but before 
we let you go, we wouldn't feel right about sending you out into JavaLand without a little more 
preparation. We can't possibly fit everything you'll need to know into this relatively small appendix. 
Actually, we did originally include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read it. So, 
we threw most of it away, but kept the best bits for this Top Ten-ish appendix. Yep, there’s more than 


ten Really Useful Things that you still need to know. 


This really is the end of the book. Except for the index (a must-read)). 
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JShell REPL 


#11 JShell (Java REPL) 
Why do you care? 


A REPL (Read Eval Print Loop) lets you run snippets of 
code without needing a full application or framework. It’s 
a great way to try out new features, experiment with new 
ideas, and get immediate feedback. We’ve put this right at 
the start of this appendix in case you want to use JShell to 
try out some of the features we'll be talking about in the 
following pages. 


Starting the REPL 


JShell is a command-line tool that comes part of the JDK. If 
JAVA_HOME/bim is on your system’s path, you can just type 
“Sshell” from the command line (full details on getting started 
are in Oracle’s Introduction to JShell (Atips://oreu. ly /E15 Df). 


[ File Edi Window Help Ammonite TTT 
$jshell 
| Welcome to JShell -- Version 17.0.2 


| For an introduction type: /help intro 


jshell> 


JShell is available only in JDK 9 and higher, but 

the good news is that even if you’re running code and 
applications on an older version of Java, you can still use 
JShell from a more recent version, since it’s completely 
independent of your “JAVA_HOME?” or IDE’s version 
of Java. Just run it directly from the di directory of 
whichever version of Java you want to use. 


Run Java code without a class 


Try out some Java from the prompt: 


jshell> System. out.println ("Hello") 
Hello 


jshell> 


Note: 
¢ No need for a class 
¢ No need for a public static main method 


¢ No need for a semicolon on the end of the line 


Just start typing Java! 
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Java 9+ 
More than just lines of code 


You can define variables and methods: 


File Edit Window Help RealJava 
jshell> String message = "Hello there " 
message ==> "Hello there " 


void greet(String name) { 
System. out.println (message+name) ; 
aaa} 
| created method greet (String) 


jshell> greet ("you") 
Hello there you 


ce needed side 


Semitolons ole Vike me ods: 


blotks ot 6° 
It supports forward references, so you can sketch out the 
shape of your code without having to define everything 
immediately. 
jshell> void doSomething() { 
> doSomethingE1se () ; 
TSy 
| created method doSomething(), however, it 
cannot be invoked until method doSomethin- 
gElse() is declared 


Code suggestions 


If you press Tab halfway through typing, you'll get code 
suggestions. You can also use the up and down arrows to 
cycle through the lines you’ve typed so far. 


jshell> System.out.pr 
printf ( 


print ( 
jshell> System.out.print 


println ( 


Commands 


There are lots of helpful commands that are part of JShell 
and not part of Java. For example, type /vars to see all 
the variables you’ve declared. Type /exit to, er, exit. 
Use /help to see a list of commands and to get more 
information. 


Oracle has a very useful JShell User Guide (https://oreil. by/ 
E.3Df), which also shows how to create and run scripts with 
JShell. 
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#10 Packages 
Packages prevent class name conflicts 


Although packages aren’t just for preventing name collisions, 
that’s a key feature. If part of the point of OO is to write reusable 
components, developers need to be able to piece together 
components from a variety of sources and build something new 
out of them. Your components have to be able to “play well with 
others,” including those you didn’t write or even know about. 


Remember way back in Chapter 6, Using the Java Library, when 
we discussed how a package name 1s like the full name of a class, 
technically known as the fully qualified name. Class List is really 
java.util. List, a GUI List is really java.awt. List, and Socket 
is really java.net.Socket. Hey presto, an example of how 


package names can help prevent name conflicts—there’s a List 
that’s a data structure and a List that’s a GUI element, and we 
can use the package names to tell them apart. 


Notice that these classes have java as their “first name.” In other 


words, the first part of their fully qualified names is “java”; 
Socket 


event 


think of a hierarchy when you think of package structures, and 


organize your classes accordingly. 


Preventing package name conflicts 


The standard package naming convention is to prepend every 


ArrayList FlowLayout 


What does this picture look like to 
you? Doesn't it look a whole lot like ActionEvent 


a directory hierarchy? 


class with your reverse domain name. Remember, domain names 
are guaranteed to be unique. Two different guys can be named 
Bartholomew Simpson, but two different domains cannot be named 


doh.com. s 
ne 
the ee Packages can prevent name 
alway? : : 
Reverse domain package names conflicts, but only #f you 


com.headfirst java.projects.Chart choose a P ackage ame that's 
" rN guaranteed to be unique. 
k wr jour . ; 
— Sul by a aaa might be a common ‘Lhe best way to do that is to 
dot (.), and then add your own me, Dut adding comheadfirstjava ka . 
S nl rubhave aber that. means we have to worry about only preface your pac ses with 


our own in-house devel ; 
Packages are lowercase evelopers your reverse domain name. 


; com.headfirstbooks.Book 
When you look at the code samples at https://oreil. ly /hffava_3e_ 


a a ‘ 
examples, you'll see we’ve put the classes into packages named after package name class al 
each chapter to clearly separate the examples. 
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#10 Packages, cont. 


To put your class in a package: 


@) Choose a package name @) Set up a matching directory structure 
We're using com.headfirstjava as our It's not enough to say your class is in a package 
example. The class name Is PackageExercise, by merely putting a package statement in the 
so the fully qualified name of the class is now code. Your class isn't truly in a package until you 
com.headfirst java.PackageExercise. put the class ina matching directory structure. 


So, if the fully qualified class name is 

. com.headfirst java.PackageExercise, you must put 
@ Put a package statement in your class the Package cence oe code in ireeteny 
It must be the first statement in the source named headfirstjava, which must be ina 
code file, above any import statements. There directory named com. 
can be only one package statement per source 
code file, so all classes in a source file must 
be in the same package. That includes inner 
classes, of course. 


package com.headfirstjava; 


import javax.swing.*; 


In most, Java Pree ets, 
public class PackageExercise { this folder is likely 
// life-altering code here be sve/ main/ jae 


} 


A note on directories 


In the Real World, source files and class files are usually kept in separate 
directories—you don’t want to copy the source code to wherever it’s running (a 
customer’s computer or the cloud), only the class files. 


The most common structure for Java projects 1s based off Maven’s* convention: 


package structure 


MyProject/src/main/java Application sources 


MyProject/src/test/java ‘Test sources 


The class files are placed elsewhere. Real enterprise systems usually use a build 
tool like Maven or Gradle to compile and build the application (our sample code 
uses Gradle). Each build tool puts the classes into different folders: 


Maven Gradle 
ar PackageExercise.java 
Application classes | MyProject/target/classes MyProject/out/production/classes 
Test classes MyProject/target/test-classes | MyProject/out/test/classes 


*Maven and Gradle are the most common build tools for Java projects. 


686 appendix B 


#10 Packages, cont. 


Compiling and running with packages 


We don’t need to use a build tool to separate our classes and source 
files. By using the -d flag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of class files 
landing in the same directory as the source code. 


Compiling with the -d_ flag not only lets you send your compiled class 
files into a directory other than the one where the source file is, but 

it also knows to put the class into the correct directory structure for 
the package the class is in. Not only that, compiling with -d tells the 
compiler to build the directories if they don’t exist. 


Compiling with the -d (directory) flag 


A | Do 
Stay in the source directory: 
Boar Myeeo ect /scuece. 5 ot te directory where the .java 
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The —d flag tells the compiler, 
“Put the class into its package 
directory structure, using the 
class specified after the -—d as 
the root directory. But...if the 
directories aren’t there, create 
them first and then put the class 
in the right place!” 


NOT ed down 
File is! 


Sjavac -d../classes com/headfirstjava/PackageExercise. java 
As fy the 
Tells the Compiler +e N ww You have to speci Y 
al 
compiled ¢o "ie Gee ha ae PAT bo oet te the actu 
In he classes directory, source *e- 


cere Yes, iE Knows. 
To compile all the .java files in the com.headfirstjava package, use: 


Sjavac -d ../classes com/headfirstjava/*.java 


Compiles ever 
ile in this directory 


Running your code 
ne Cnn Program from 


ny, 
cd MyProject/classes Classes directory. 


Sjava com.headfirstjava.PackageExercise 


You MUST 4; 
Give the full lif 
see that and immedi Y qudlitied class namel Th 
' xpee: ind di Y named ¢ 
there it ihe directory named headfiretis. 
rie expects to find the élass. if pottirstjava 


, or eve . ity are 
y nin ‘Classes,’ it won't work! 


) where 
) ) and in 
IS in the “tom” 


Y Source (java) 


PackageExercise.class 


foy\\ still compile 


rom here 


eA 


PackageExercise.java 
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#9 Immutability in Strings and Wrappers 


We talked about immutability in Chapter 18, and we'll 
mention immutability in the last item of this appendix. 
This section is specifically about immutability in two 
important Java types: Strings and Wrappers. 


Why do you care that Strings are immutable? 


For security purposes and for the sake of conserving 


memory (whether you’re running on phones, IoT devices, 
or the cloud, memory matters), Strings in Java are 
immutable. What this means 1s that when you say: 

String s = "0"; 

for (int i=1; i < 10; i++) { 

s=s +i; 

} 
what’s actually happening is that you’re creating ten 
String objects (with values “0,” “O1,” “012,” through 
“0Q123456789”). In the end, s is referring to the String with 
the value “0123456789,” but at this point there are ten 
different Strings in existence! 


Similarly, if you use methods on String to “change” a 
String object, it doesn’t change that object at all; it creates 
a new one: 


String str = "the text"; 
String upperStr = str.toUpperCase() ; 


= oh” : ® Creates a 
new u ; changed; C'S returns a 
THE Tey String sa “ ie bent String object 


How does this save memory? 


Reference an 


Whenever you make a new String, the JVM puts it into a 
special part of memory called the “String Pool” (sounds 
refreshing, doesn’t it?). If there is already a String in the 
pool with the same value, the JVM doesn’t create a duplicate; 
it refers your reference variable to the existing entry. So 
you won't have 500 objects of the word “customer” (for 
example), but 500 references to the single “customer” 
String object. 


String strl = "customer"; 

String str2 = "customer"; 

System.out.println(strl == str2); 
SaaS 


are not only . 
Le they re the same object 
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immutability makes reuse possible 


The JVM can get away with this because Strings are 
immutable; one reference variable can’t change a 
String’s value out from under another reference variable 
referring to the same String. 


What happens to unused Strings? 


Our first example created a lot of intermediate Strings 
that weren’t used (“O1,” “012,” etc). These were placed 
in the String Pool, which is on the heap and therefore 
eligible for Garbage Collection (see Chapter 9). Strings 
that aren’t used will eventually be garbage-collected. 


However, if you have to do a lot of String manipulations 
(like concatenations, etc.), you can avoid the creation of 
unnecessary strings by using a StringBurlder: 


StringBuilder s = new StringBuilder ("0") ; 

for (int i=1; i < 10; it+) { 
s.append (i) ; 

} 

String finalString = s.toString() ; 


This way, the single mutable StringBuilder is updated 
every time to represent the intermediate states, instead 
of ten immutable String instances being created and the 
nine intermediate Strings being thrown away. 


Why do you care that Wrappers are 
immutable? 


In Chapter 10, we talked about the two main uses of the 
wrapper classes: 


¢ Wrapping a primitive so it can act like an object. 
¢ Using the static utility methods (e.g, Integer.parseInt()). 


It’s important to remember that when you create a 
wrapper object like: 


Integer iWrap = new Integer (42) ; 


that’s it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper 
object. You can, of course, refer Wrap to a different 
wrapper object, but then you'll have two objects. Once 
you create a wrapper object, there’s no way to change 
the value of that object! 
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#8 Access levels and access modifiers (who sees what) 


Java has four access levels and three access modifiers. There are only three modifiers because the 
default (what you get when you don’t use any access modifier) is one of the four access levels. 


Access levels (in order of how restrictive they are, from least to most restrictive) 


; publie means any Code anywhere Can access the public thing (by 
public <—— ‘thing” we mean ¢lass, variable, method, constructor, ete.). 


protected ¢—_ protected works just like default (eode in the same package has access), EXCEPT it 
also allows subclasses outside the package to inherit the protected thing, 


default — default aecess means that only Code within the same package as 


the class with the default thing can access the default thing. 


<— private means that only code within the same ¢lass can access the private thing, 
Keep in mind it means private to the ¢lass, not private to the object. One Dog can 
see another Dog object’s private stuff, but a Cat can't see a Dog's privates. 


private 


Access modifiers 


public 
protected 


private 


Most of the time you'll use only public and private access levels. 


public 


Use public for classes, constants (static final variables), and methods that you’re exposing to 
other code (for example getters and setters) and most constructors. 


private 


Use private for virtually all instance variables, and for methods that you don’t want outside code 
to call (in other words, methods used by the public methods of your class). 


Although you might not use the other two (protected and default) much, you still need to know 


what they do because you'll see them in other code. 
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access levels 
#8 Access levels and access modifiers, cont. 
default and protected 


default 


Both protected and default access levels are tied to packages. Default access is simple—it means 
that only code within the same package can access code with default access. So a default class, for 
example (which means a class that isn’t explicitly declared as public) can be accessed by only 
classes within the same package as the default class. 


But what does it really mean to access a class? Code that does not have access to a class is not 
allowed to even ¢hink about the class. And by think, we mean use the class in code. For example, 
if you don’t have access to a class, because of access restriction, you aren’t allowed to instantiate 
the class or even declare it as a type for a variable, argument, or return value. You simply can’t 
type it into your code at all! If you do, the compiler will complain. 


Think about the implications—a default class with public methods means the public methods 
aren't really public at all. You can’t access a method if you can’t see the class. 


Why would anyone want to restrict access to code within the same package? Typically, packages 
are designed as a group of classes that work together as a related set. So it might make sense 
that classes within the same package need to access one another’s code, while as a package, only 
a small number of classes and methods are exposed to the outside world (1.e., code outside that 
package). 


OK, that’s default. It’s stsmple—if something has default access (which, remember, means no 
explicit access modifier!), only code within the same package as the default thing (class, variable, 
method, inner class) can access that thing. 


Then what’s protected for? 


protected 
Protected access is almost identical to default access, with one exception: it Experienced developers 


allows subclasses to inherit the protected thing, even if those subclasses are outside the Orn) D ° 
package of the superclass they extend. That’s it. That’s all protected buys you—the writing libraries for other 


ability i “ ne ara be nue ee superclass package, yet still intert developers to use wil] find 
pieces of the class, including methods and constructors. both default and prot d 
ecte 


Many developers find very little reason to use protected, but it is used in some 
designs, and some day you might find it to be exactly what you need. One of access levels very helpful. 


the interesting things about protected is that—unlike the other access levels — 


protected access applies only to inheritance. If a subclass-outside-the-package These access levels can 
has a reference to an instance of the superclass (the superclass that has, say, a e 
: eosin ea x. Separate the internals of a 


protected method), the subclass can’t access the protected method using that 


superclass reference! ‘The only way the subclass can access that method 1s by library from the API that 


inheriting it. In other words, the subclass-outside-the-package doesn’t have access 


to the protected method; it just has the method, through inheritance. other developers will eal] 
from their code. 
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#7 Varargs 


We saw varargs briefly in Chapter 10, Numbers Matter, when we looked at the String.format() method. You also saw 
them in Chapter 11, Data Structures, when we looked at convenience factory methods for Collections. Varargs let a method 
take as many arguments as they want, as long as they’re of the same type. 


Why do you care? 


Chances are, you won’t write many (or any!) methods with a vararg parameter. But you will likely use them, 
passing in varargs, since the Java libraries do provide helpful methods, like the ones we just mentioned, that can 
take as many arguments as they like. 


How can | tell if a method takes varargs? 


Let’s look at the API documentation for String.format(): 


static String format(String format, Object... args) 
The triple dot (...) says this is method takes an arbitrary number of Objects after the String argument, including 
. For example: Q 
i Pentles for the format | 
String msg = String. format ("Message") ; method but vali went eee 


irargs ar 
String msgName = String.format("Message for %s", name) ; One varary 9 


. Two varargs arguments, 


4 — 1 W W 
String msgNumName = String.format("%d, messages for %s", number, name) ; it idee ani wame 


Methods that take varargs generally don’t care how many arguments there are; it doesn’t matter much. Consider 
List.off), for example. It doesn’t care how many items you want in the List; it will just use add all the arguments 
into the new list. 


Creating a method that takes varargs 


You will generally be calling a method that takes varargs, not creating it, but let’s take a look anyway. If you 
wanted to define your own method that, for example, printed out everything passed into it, you could do it 
like this: 


void printAllObjects (Object... elements) { 
for (Object element : elements) { 
System.out.println (element) ; 
} 
} 


The parameter elements is nothing magic; it’s actually just an array of Objects. So you can iterate over it the same 
way as if you’d created the method signature as: 


void printAllObjects(Object[] elements) { 


It’s the calling code that looks different. Instead of having to create an array of objects to pass in, you get the 
convenience of passing in an arbitrary number of parameters. 


Rules 


e« A method can have only one varargs parameter. 


¢ The varargs parameter must be the last parameter. 
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#6 Annotations 


Why do you care? 


We very briefly mentioned annotations back in Chapter 
12, Lambdas and Streams: What, Not How, when we said 

that interfaces that can be implemented as a lambda 
expression may be marked with a “@Functionallnterface” 
annotation. 


Adding an annotation to your code can add extra 
behavior, or an annotation can be a kind of compiler- 
friendly documentation; i.e., you’re simply tagging 
the code with some additional information that could 
optionally be used by the compiler. 


You will definitely see annotations used in the Real World, 
and very likely use them. 


Where will you see annotations? 


You will see annotations in code that uses libraries and 
frameworks like Java EE/Jakarta EE, Spring/Spring Boot, 
Hibernate and Jackson, all of which are very commonly 
used in the Java world for building large and small 


applications. Cl ass-level annotation 


@SpringBootApplication <— 

public class HelloSpringApplication { 
Where you will definitely see annotations is in test code. 
Back in Chapter 5, Extra-Strength Methods, we introduced 
the idea of testing your code, but what we haven’t shown 
is the frameworks that make it much easier. ‘The most 
common one is JUnit. If you look at the code samples at 
https://oreil. ly/hffava_3e_examples, you'll see there are some 
example test classes in the “test” folder. 


@Test £—Method-level annotation 
void shouldReturnAMessage() { 


Annotations can he applied to classes 
and methods, to variables (Jocal and 
instance) and parameters, and even 
some other places in the code. 
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Annotations can have elements 


Some annotations include elements, which are like 
parameters with names. 


@Table (name="cust") 
public class Customer { 


If the annotation has only one element, you don’t need to 
give the name. 


@Disabled("This test isn't finished") 
void thisTestIsForIgnoring() { 


As you saw in the earlier examples, you don’t need to add 
y ples, y' 
parentheses to an annotation that doesn’t have elements. 


You can add more than one annotation to the class, 
method, or variable that you’re annotating. 


What do they do? 


Well, it depends! Some can be used as a sort of compiler- 
safe documentation. If you add @FunctionalInterface to 
an interface with more than one abstract method, you'll 
get a compiler error. 


Other annotations (like @NotNull) can be used by your 
IDE or by analysis tools to see if your code is correct. 


Many libraries provide annotations for you to use to tag 
parts of your code so the framework knows what to do 
with your code. For example, the @Test annotation tags 
methods that need to be run as individual tests by JUnit; 
@SpringBootApplication tags the class with the main 
method that’s the entry point of a Spring Boot application; 
@Entity tags a Java class as a data object that needs to be 
saved to a database by Hibernate. 


Some annotations provide behavior on top of your code. 
For example, Lombok can use annotations to generate 
common code: add @Data to the top of your class, and 
Lombok will generate constructors, getters and (if needed) 
setters, and hashCode, toString, and equals methods. 


Sometimes annotations seem to work like 
magic! The code that does the hard work 
is hidden away. If you use annotations 
that are well documented, you’ll have a 


better understanding of what they do and 
how they work. This will help you fix any 
issues you may run into. 
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#5 Lambdas and Maps Java 8+ 
Why do you care? 


Java 8 famously added lambdas and streams to Java, but what 1s less well-known 

is that java.util.Map also got a few new methods that take lambda expressions as 
arguments. These methods make it much easier to do common operations on Maps, 
which will save you time and brainpower. 


Create a new value if there isn’t one for the key 


Imagine you want to track what a customer does on your website, and you do this 
using an Actions object. You might have a Map of String username to Actions. When 
a customer performs some action that you want to add to their Actions object, you 
want to either: 


* Create a new Actions object for this customer and add it to the Map 
¢ Get the existing Actions object for this customer 


It’s very common to use an 7f statement and a null check to do this (pre-Java 8): 


Map<String, Actions> custActs = new HashMap<>(); ; ; 
// probably other stuff happens here... See if there's an Aetions 


, object for the username. 
Actions actions = custActs.get (usr); 


if (actions == null) { ————44 glue doesn't exist 


etions and 
actions = new Actions(usr); --S80 ereate a yoni the 


custActs.put(usr, actions) ; add it to the k 
} username aS the key- 


// do something with actions 


It’s not a lot of code, but it is a pattern that is used again and again. If you’re using 
Java 8 or higher, you don’t need to do this at all. Use computelfAbsent, and give 
it a lambda expression that says how to “compute” the value that should go into the 
Map if there isn’t an entry for the given key: L 
ions objec 
. the Actions 0b) 
Actions abject ries the Mar: 


ame wasn 


ig is EITHER the existing 
This ts 


if the usern 
the lambda | 
Actions actions = treated by 


custActs.computeIfAbsent (usr, name -> new Actions (name) ); 


This lambda says how to treate a ne 
value (an Actions) if the seerane: . 
doesn't have an Actions in the Map yet. 


This is the k ) 
Z e 
coking for in Ehe Mp, 
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#5 Lambdas and Maps, cont. 


Update the value only if it already exists 


There may be other scenarios when you want to update a value in the Map only if it exists. For 
example, you might have a Map of things that you are counting, like metrics, and you want to 

update only the metrics that you care about. You don’t want to add any arbitrary new metric to 
the Map. Before Java 8, you might use a combination of contains, get, and put to check if the map 
has a value for this metric and update it if so. 


ee £ he mer AI Ss k in the 
M. < 7 , n > 7 = new <> ( ) , . {| e et) 10 e ists a a (2 n € 
ff 1a y her ns here... GS \ ihe i i a adil a 
Ss resi is W or nov 
ae ; N ! at . } " 
an f Ss ae 


if (metrics.containsKey(metric)) { 
Integer integer = metrics.get (metric) ; <|f£ it’s in the maP) get the value. 
metrics.put(metric, ++integer) ; Increment th 


} it baek in ate and put 


Java 8 added computelfPresent, which takes the key you’re looking for and a lambda 
expression, which you can use to describe how to calculate the updated value for the Map. 
Using this, the code above can be simplified to: 


metrics.computeIfPresent(metric, (key, value) -> ++value); 


wk th 
urns the new ae Vas ‘ The lambda 


This also re ( \\ if not), bu Parameters ay, th 

in the map (or snes and th BETeKE 
ee hart ae ox our EXIMPIE This is the Ae taléuls rf re and we ¢an use these to 
Ww A 


were looking, 


new value [F the key exists 


in the map. 


Other methods 


There are other, more advanced methods on Map that can be useful when you want to “add 
a new value OR do something with the existing value” (or even remove a value), like merge 
and compute. There’s also replaceAll, which you can give a lambda expression that calculates a 
new value for all the values in the map (we could use this, for example, to increment ALL the 
metrics in our previous example, if we needed to). And, like all the collections, it has a forEach 
that lets us iterate over all the key/value pairs in the Map. 


The Java libraries continuously evolve, so even if you think you understand something you’ve 
used a lot, like List or Map, it’s always worth keeping an eye out for changes that may make 
your life easier. 


Remember, the Java API documentation (https://oreil.ly/In5xn) is a great place to start if you 
want to see what methods are available on a class, and what they do. 
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#4 Parallel Streams 


Back in Chapter 12, Lambdas and Streams: What, Not How, 
we took a long look at the Streams API. We did not look 
at one of the really interesting features of streams, which 
is that you can use them to take advantage of modern 
multicore, multi-CPU hardware and run your stream 
operations in parallel. Let’s look at that now. 


So far, we’ve used the Streams API to effectively “query” 
our data structures. Now, imagine those data structures 
can get big. We mean REALLY big. Like all the data from 
a database, or like a real-time stream of data from a social 
media API. We could plod over each of these items one by 
one, in serial, until we get the results we want. Or, we 
could split the work up into multiple operations and run 
them at the same time, in parallel, on different CPUs. 
After Chapters 17 and 18 you might be tempted to run off 
and write a multithreaded application to do that, but_you 
don’t have to! 


Going parallel 


You can simply tell the Streams API you want your stream 
pipeline to be run on multiple CPU cores. There are two 
ways to do this. 
: Remember our mock ey 
data from Chapter 1° 
getSongs(); 
songs.parallelStream() ; 


1. Start a parallelStream 


List<Song> songs = 
Stream<Song> par = 


2. Add parallel() to the stream pipeline 


List<Song> songs = 
Stream<Song> par = 


getSongs (); 
songs.stream() 
.parallel (); 


They both do the same thing, and you can choose 
whichever approach you prefer. 


OK now what? 


Now, you just write a stream pipeline just like we did in 
Chapter 12, adding the operations you want and finishing 
off with a terminator. The Java libraries will take care of 
figuring out: 


* How to split the data to run the stream pipeline on 
multiple CPU cores 


* How many parallel operations to run 


* How to merge the results of the multiple operations 
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Multithreading is taken care of 


Under the covers, parallel streams use the Fork-Join 
framework (which we did not cover in this book; see 
hitps://oreil. ly/Xf6eH), yet another type of thread pool 
(which we did talk about in Chapter 17, Make a Connection). 
With parallel streams, you'll find the number of threads 

is equal to the number of cores available wherever your 
application is running. There are ways to change this setup, 
but it’s recommended to stick with the defaults unless you 
really know what you’re doing. 


Do not use parallel everywhere! 


Before you going running off and making all your stream 
calls parallel, wait! Remember we said back in Chapter 18, 
Dealing with Concurrency Issues, that multithreaded programming 
was hard, because the solutions you choose depend a lot on 
your application, your data, and your environment? The 
same applies to using parallel streams. Going parallel and 
making use of multiple CPU cores is not free and does not 
automatically mean your application will run faster. 


There is a cost to running a stream pipeline in parallel. The 
data needs to be split up, the operations need to be run on each 
bit of data on separate threads, and then at the end the results 
of each separate parallel operation need to be combined in 
some way to give a final result. All of that adds time. 


If the data going into your stream pipeline is a simple 
collection, like the examples we looked at in Chapter 12 
(indeed, in most places streams are used today), using serial 
streams 1s almost definitely going to be faster. Yes, you read 
that correctly: for most ordinary use cases, you do not 
want to go parallel. 


Parallel streams can improve performance when: 


¢ The input collection is BIG (think hundreds of 
thousands of elements at least) 


¢ The stream pipeline is performing complicated, long- 
running operations 


¢ The decomposition (splitting) of the data/operations 
and merging of the results are not too costly. 


You should measure the performance with and without 
parallel before using it. If you want to learn more, Richard 
Warburton’s Java 8 Lambdas book has an excellent section 
on data parallelism. 
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#3 Enumerations (also called enumerated types or enums) 


We’ve talked about constants that are defined in the API, for instance, JFrame 
.EXIT_ON_CLOSE. You can also create your own constants by marking a variable 
static final. But sometimes you'll want to create a set of constant values to 
represent the only valid values for a variable. This set of valid values is commonly 
referred to as an enumeration. Full-fledged enumerations were introduce way back 


in Java 5. 
Who’s in the band? 


Let’s say that you’re creating a website for your favorite band, and you want to make 
sure that all of the comments are directed to a particular band member. 


The old way to fake an “enum”: 


public static final int KEVIN = 1; 
public static final int BOB = 2; 
public static final int STUART = 3; 


We've hoping that by the time we got here 


// later in the code “seleetedBandMember-” has 4, valid vated 


if (selectedBandMember == KEVIN) { 
// do KEVIN related stuff 


The good news about this technique is that it DOES make the 
code easier to read. The other good news is that you can’t ever 
change the value of the fake enums you’ve created; KEVIN 
will always be 1. The bad news is that there’s no easy or good 


way to make sure that the value of selectedBandMember P 
will always be 1, 2, or 3. If some hard-to-find piece of code This IS the OLD way to fake an 
sets selectedBandMember equal to 812, it’s pretty likely enum, but you will stil] see code 


your code will break. like this in Real Life (e.g., the 
older Java libraries like AWT). 


However, if you have any 
contro] over the code, try to use 
enums instead of constants like 
this. See the next page... 
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#3 Enumerations, cont. 


Let’s see what the band members would look like with a “real” enum. While this is 


ekinition 
a very basic enumeration, most enumerations usually are this simple. £1 vs Vee 2 § pie ane d 
ik ooks kb enum ew 
An official “enum” Peis Mine ne aut tna e created 2” 
oes cla Ww er 
< ° Mer’ 
public enum Member { KEVIN, BOB, STUART }; ayetial 8 Lyre called 
enum 


public class SomeClass { 
public Member selectedBandMember; 


// later in the code... se The “seleetedBandMember” Variable is of type 


void someMethod() { “Member,” and ea 
if (selectedBandMember == Member.KEVIN) { “KEVIN,” “BoB,” ee = 


// do i aaa stuff \ 
} 


} No need to worry about this variable’s value! 


The syntax to refer to an enum “instance” 


Your enum extends java.lang.Enum 


When you create an enum, you’re creating a new class, and you’re implicitly extendin 
»y g ) J Lp ly Ss 
java.lang.Enum. You can declare an enum as its own standalone class, in its own source 


file, or as amember of another class. 


Using “if” and “switch” with enums 


Using the enum we just created, we can perform branches in our code using either the if or 
switch statement. Also notice that we can compare enum instances using either == or the 
.equals0 method. Usually == is considered better style. 


(ie soe SCS” 


Assigning an enum value to a variable 


if (member.equals (Member. KEVIN) ) of these work Cine! 
System.out.printin("Bellloooo!"); Both ea 
-. printed: 
if (member == Member.BOB) “Poth a 


System.out.printin("Poochy") ; 


switch (member) { -— Pop Quiz! What’s the output? 


case KEVIN: System.out.print("Uh... la cucaracha?"); 


case BOB: System.out.printin("King Bob"); 
case STUART: System.out.print ("Banana!"); 
} 


You can add a bunch of things to your enum like a constructor, methods, variables, ‘iaie 
and something called a constant-specific class body. They’re not common, but you I q 


might run into them. Answer: rd burrs 
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#2 Local Variable Type Inference (var) 


If you’re using Java 10 or higher, you can use var when 
youre declaring your Jocal variables (1.e., variables inside 
methods, not method parameters or instance variables). 


var name = "A Name"; ame is a String 


This is another example of type inference, where the 
compiler can use what it already knows about the types to 
save you from writing more. The compiler knows name is 
a String because it was declared as a String on the right 
hand side of the equals sign. 


 Arevayist 
var bakes = new ArrayList<>() ; 


var customers = getCustomers() ; 


Cig getCustomerst) returns List<Customer>> 
this is a List<Customer>- 


Type inference, NOT dynamic types 


When you declare your variable using var, it still has a 
type. It’s not a way of adding dynamic or optional types 
to Java (it’s not like Groovy’s de/). It’s simply a way of 
avoiding writing that type twice. 
You do have to somehow tell the compiler what the type is 
when you declare the variable. You can’t assign it later. So, 
you can’t do this: 

var name; Does NOT compilel! 
because the compiler has no idea what type name is. 
It also means that you can’t change its type later: 


var someValue = 1; e 1 
someValue = "String"; — Does NOT compile. 


Someone has to read your code 


Using var does make the code shorter, and an IDE can tell 
you exactly what type your variable is, so you might be 
tempted to use var everywhere. 


However, someone reading your code might not be using 
an IDE or have the same understanding of the code as 
you. 


We did not use var in this book (even though it would 
have been easier to fit the code on the pages), because we 
wanted to be explicit to you, the reader, about what the 
code was doing. 
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Tip: Better with useful variable names 


If you don’t have the type information visible in the code, 
descriptive variable and method names will be extra 
helpful to a reader. 


var reader = newBufferedReader (get ("/") ) ; 
var stuff = doTheThing() ; 


We have No IDEA what this is 
Tip: Variable will be the concrete type 


In Chapter 11 we started “programming to interfaces”; 
i.e., we declared our variables as the interface type, not the 
implementation: 


List<String> list = new ArrayList<>(); 
If you’re using var, you can’t do this. The type will be the 
type from the right-hand side: 


var list = new ArrayList<String>() ; 
his 1s a" ; . 
Hayle Stn? 
Tip: Don’t use var with the diamond 
operator 


Look at the last example. We declared list first as a 
List<String> and used the diamond operator (<>) on the 
right-hand side. The compiler knows the type of the list 
element is a String from the lefthand side. 


If you use var, like we did in the second example, the 
compiler no longer has this information. If you want the 
list to still be a list of Strings, you need to declare that on 
the righthand side; otherwise, it will contain Objects. 


var list = new ArrayList<>() ; 


Read all the style guidelines from the OpenJDK developers 
(https://oreil. ly/e VfSd). 


#1 Records 
Why do you care? 


A “simple” Java data object is often not simple at all. Even 
a data class (sometimes called a Java Bean, for historical 
reasons) with only a couple of fields requires quite a lot 
more code than you might expect. 


A Java data class, before Java 16 


Imagine a basic Customer class, with a name and an ID: 


public final class Customer { 
private final int id; 
private final String name; 


public Customer(int id, String name) { 
this.id = id; 
this.name = name; 


} 


public int getId() { 
return id; 


} 


public String getName() { 
return name; 


} 


public boolean equals(Object o) { } 
public int hashCode() { } 


public String toString() { } 
} 


We've left out the details of the equals, hashCode, and 
toString methods, but you would probably want to 
implement those methods, especially if you’re going to 

use this object in any collections. We’ve also left off the 
“setters”; this is an immutable object with final fields, but in 
some cases you might want setters as well. 


That’s a lot of code! It’s a simple class with two fields, and 
the full code, including implementation, is 41 lines! 
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What if there was a special syntax 
for data classes? 


Guess what? If you’re using Java 16 or higher, there is! 
Instead of creating a class, you create a record. 


These are the vetord’s 
components- These translate 
into instante variables and 
an attessor method tor the 


’ Ps 
Don’t use “Class,” use « variable. 
€ vretord.” a —_—4—™™. 
public record Customer(int id, String name) {} 


is vetord header also defines what 
ee looks like (the — 
the parameters for the constructor). 


That’s it. That’s all you need to do to replace the 42 lines of 
code of the “old” Customer data class. 


A record like this one has instance variables, a constructor, 
accessor methods, and equals, hashCode, and toString methods. 


Using a record 


When you're using a record that’s already been defined, it 
looks exactly the same as it would if the record class was a 
standard data class: 


Customer customer = new Customer(7, "me") ; 

System.out.println (customer) ; 

System.out.println (customer .name () ) ; 

Notice thie ; 
The output looks like: € this is No 
P getName(). . 

” 
$java UsingRecords Retor ds have a pret | 


foSbring, by default: 


Customer [id=7, name=me] 
me 


Goodbye “get” 


Did you notice something? Records don’t use the classic 
“get” prefix for the methods that let you read the instance 
variables (hence we carefully called them “accessors” 

and not “getters”’). They just use the name of the record 
component as the method name. 
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#1 Records, cont. 


You can override constructors 


The constructor, accessors, and equals, hashCode, and 
toString methods are all provided by default, but you can 
still override their behavior if you need something specific. 


Most of the time, you probably won’t need to. But if you 
want, for example, to add validation when you create the 
record, you can do that by overriding the constructor. 


public record Customer(int id, String name) { 
public Customer(int id, String name) { 
if (id < 0) { 
throw new ValidationException () ; 
} 
this.id = id; 
this.name = name; 
} 
} 


Actually, it’s even easier than that. The example above 
is a canonical constructor, i.c., the normal kind of 
constructor we’ve been using everywhere. But records also 
have a compact constructor. This compact constructor 
assumes all the normal stuff is taken care of (having the 
right number of parameters in the right order, and all 
assigned to the instance variables) and lets you define only 
the other stuff that matters, like validation: 

what the 


Record header defines \ 
ac fr on 3 ucto looks like when lou ta 
constr \ a + 
publi ecord Cust Gi es Y' ' 


No need to define the 
public Customer { fonstructoy parameters 


| . 
if (id < 0) ¢ Can still access the parameters 
throw new ValidationException () ; 


) Noweed He assign anything to 


} the instance variables 


} 


When you call the Customer’s constructor, you still need 
to pass it an ID and a name, and they will still be assigned 
to the instance variables (that’s all defined by the record 
header). All you need to do to add validation to the 
constructor is use the compact form and let the compiler 


take care of all of the rest. 
Customer customer = new Customer (7, 


Even with a compact constructor You must pass 
in arguments for all of the record components. 


"me") : 
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You can override or add methods 


You can override any of the methods and add your own 
(public, default, or private) methods. If you are migrating 
existing data classes to use records, you may want to keep 
your old equals, hashCode, and toString methods. 


public record Customer(int id, String name) { 


public boolean equals(Object o) { 
return id == ((Customer) 0) .id; 
} Overvides the equals method to 
provide custom behavior 
private boolean isValidName (String name) { 


// some implementation 
} Retords can have 


} normal 


You can create a protected method; the compiler won’t stop 
you, but there’s no point—records are always final classes 
and can’t be subclassed. 


Records are immutable 


In Chapter 18, we talked about making data objects 
ammutable. Immutable objects are safer to use in concurrent 
applications, because you know that it’s impossible for more 
than one thread to change the data. 


It’s also easier to reason about what’s happening in your 
application if you know the data classes can’t change, so 
even in applications that aren’t multithreaded, you may 
find immutable data objects being used. And in #9 in this 
appendix we saw how immutability in Strings can save 
memory. 


Records are immutable. You can’t change the values in 

a record Object after you have created it; there are no 
“setters” and no way to change the instance variables. You 
can’t access them directly from outside the record, only 
read them via the accessor method. 


If you try to change one of the record’s instance variables 
from inside the record, the compiler will throw an 
exception. A record’s instance variables are final. 


Find out more about records in Oracle’s Record Classes 
documentation (htips://oreil. ly/D7fh3). There, you can 

also read about some of the other new language features 
available in Java 17 that we didn’t get a chance to cover, like 
Pattern Matching, Sealed Classes, Switch Expressions, and 
the very useful Text Blocks. 
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parameters. See also arguments 
lambda expressions 402 
and local variables 85 


matching with instance variable types 76 
and methods 74, 76 
type. See type parameters 
parse methods 294 
pass-by-value/pass-by-copy 77 
Path interface 572-573 
Paths class 572-573 
percent sign (%) in format String 297-300 
PetShop program 220-228 
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security 
and final classes 191 
from package organization in Java library 156 


semicolon (;) 12 

Sequence 446-447 

Sequencer class 424-427, 444, 446-447 
Serializable interface 547—550 


serialization 540, 541-550 
game characters example 554-555 
process 544-546 
versioning 556-557 
writing object to file with stream 542-543 


serialVersionUID 557 
server application, networking 601—603 
server-client relationship 589-593 


server, socket 601 
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ServerSocketChannel 601-602 
Set interface 345, 349 
setLayout(null) 522 
setLocationCells() 102 

Set.of() 357 

setter methods 80-82 

Setters. See Getters and Setters 
short circuit operators (&& ,| |) 151 
ShortMessage instance 450 
ShortMessage.setMessage() 450, 498 
short primitive type 51, 53 
shutdown() 629 

Simple Startup Game 98-124 


SimpleStartupGame class 108-111, 126-130 


SimpleStartupTestDrive class 103-106 
Single Abstract Method. See SAM 

Sink a Startup game 96-97, 140-153 
skip(), Stream 375 

sleep() 622-624 

Socket 596-602 

SocketAddress 594, 595 
SocketChannel 591, 594, 595, 601-602 
Song class 316 

Song object 316-319 

sort() 318-319, 325-330 

sorted() 375, 381, 390 


sorting 
Comparable interface 325-329 
with Comparator 331-338 
List 311-313 
TreeSet 352-354 


source, event 466 

source files, structure of 7 
spillage, variable values 52 
split() 570 
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stack 238-241 
calling methods from 239 
superclass constructor 254-256 
threads 610-614 
variable declarations 238 


stack frame 239 
stack variables. See local variables 
StartupBust class 141-148 
Startup class 138-139, 141, 150 
Startup objects 143 
statements 12 
state of an object. See instance variables 
static final variables 275, 284, 696 
static helper method 408 
static imports 303 
static initializer 284 
static methods 396 

event handling 498-499 


and object locking 649 
and wrappers 294 
static variables 
initializing 283 
versus Instance variables 304-305 
and non-static methods 286 
and serialization 553 
stream pipeline 
creating 379-381 
map operation 405-407 
streams (I/O) 
reading text files 566 
receiving messages 594 
in serialization of object 542-543 
socket connections 596 


streams (Streams API) 369, 373, 375-420 


building blocks 379-381 
collecting results 409-410 
filtermg 400-403 

getting results from 378 
inability to reuse 384 


lambda expressions 388-397 
parallel streams 695 
stream() 376, 384 


String arrays 19 
StringBuilder 688 

String class 191 
String.format() method 296 


Strings 62 
immutability 688 
percent sign (%) in 297-300 
reusing 688 
saving data to text file 559-571 
sorting in mock Songs class 311-313 
split() 570 
wrapping and unwrapping 294—295 
subclasses 31, 168-194 
conditions for making 229 
depth of, best practices 191 
as extensions of superclass 179-183 
as instantiators under abstract classes 203 
limitations on 191 
method implementation designs for 174, 175 
and polymorphism 190 
relationship to superclass 182 
and superclass constructors 256 
super() 256, 258 
superclass 31, 168-194 
contract rules 192 
in exception declaration and catch 436-437 
Graphics 474 
invoking superclass version of method 230 
and multiple inheritance 224-225 
and no reverse inheritance 182-186 
overriding methods from 192 
reference type as 188 
relationship to subclasses 179, 184 
superclass constructor 252—259 
super keyword 182 
Swing 462, 464, 509-532 
components 510, 523-527 
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GUI for Beatbox 528-533 
layout managers 511-522 


switch statement 697-698 


synchronization for concurrency in accessing objects 


646-654 
synchronized block or methods, threads 647-649 
synchronized keyword 646-649 
syntax 12, 14 
System.out.print() 15 
System.out.println() 15 


T 


TDD (Test-Driven Development) 101—103 
temporarily not-runnable, thread as 617-619 


terminal operations 377 
collection query options 410-412 
as eager 382-383 
stacking 380 


in stream operations 379 
test code 99, 145 
Test-Driven Development. See TDD 
tester class 36 
testing code, annotations in 692 
text area (JTextArea) 524-525 
text field (JTextField) 523 


text file 
reading from 566-571 
saving data to 540 
writing data to 541, 559-564 


this() 258 

Thread class 609-610 

Thread constructor 614 

thread of execution 609-610 
thread pools 626-629 

threads. See multithreading 
thread-safe data structure 664-666 
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thread scheduler 617-619 
throw clause, exceptions 426, 429-432, 436 
toString() 316 
Track 446 
transient keyword 550 
transient variables 549, 553 
TreeSet 352-354 
try/catch blocks 427-430 
catching multiple exceptions 435, 438 
exception handling role 443 
flow control 432-433 
order of multiple 437-440 
as polymorphic 436-440 
wrapping callin 444 
TWR (try-with-resources) statement 576-577 
type inference 312, 698 
type modifiers, number formats 301 


type parameters 
ArrayList 323 
generic methods 324, 362 
not defined in class declaration 324 
String in angle brackets as 137 
types 
for lambda expression 394 


parameters and methods 78 
variables 50 


U 


underscores for large numbers, formatting 296 


unwrapping a value 290 


V 


values, variable 
object reference as 55 
passing when calling a method 74 
static variables 283 


wrapping and unwrapping 290 
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varargs (variable argument lists) 302, 691 


variables 
in arrays 59-62 
assigning values to 52 
comparing types 86 
concrete type with var 698 
declaring 54, 84, 85, 116, 144 
descriptive naming best practice 698 
final 275, 284-286 
of generic types 321 
instance. See instance variables 
local. See local variables 
naming 50-52, 61 
primitive. See primitive variables 
reference. See reference variables 
static. See static variables 
syntax 12 
types 41 
var for local 698 
version ID, serialization 556-557 
vertical scrollbar 527 


virtual method invocation 177 


W 


while loops 13, 115, 566 
widgets 471 
drawing 2D graphics 471 
images on 473 
wrapper constructor 290 
wrappers 
immutability 688 
Optional as 410-414 
for primitive types 290-294 


writeObject() 543 
Writer 595 
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